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Abst r act; 


This- caper describes LLQGO, am imp'emenlation o! I he LOGO laneua^e wrilten m MACLISP 
for I h« ]TSi TEN5Q and TENEX PDP-1Q systems, and MULTICE. The relaliyg merit* of LOGO and LISP 
*s educa'IiQndjI languages are diFcussed. Design electrons in 1h<j LtS* 3 iinptemcnlstKjn of LOGO are 
[.entrusted with those oi Iwo Cilhor implementations: OLOtaj lor (he PDP-10 and 11LGQ0 for Ihe 
PDP-i 1, bolh writlen in assembler ‘aneya B c. LLOGQ’s special facilities Far character ■oriented display 
terminals., graphic display "fvrllos H , and music general ion are also described. 
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Stctiwi L Why Iinpfcmrnt i.QCO in LISP 


LISP has proved itself to be a powerful language tor representing complex Ifif^^liOn 
processing tasks. Thus, power items irom: 

t. Ibe uniform representation ol programs and data. 

2. The ability to build arbitrarily compter data structures in the form of s-pypressions. 

3. Recyr-siorh. 

Pow^r, .however, is not necessarily good pedagogy. LOGO is a computer language designed 
especially for [He beginner, Its purpose is to introduce the fundamental ideas ol compulation *j 
clearly possible, 

L15P LOGO h an implementation ot LOGO In LTS 13 . Jt hai been designed lor several r* 4 sens. 
he J|rs t 15 thes e two languages share a fundairental core in common. Bolh are !irt*e shared, 
Interprets* languages capatjt* pi lull recursion, Variable and procedure names may be any string of 
letters and digits, Sub -procedure definitions are incfepandenl ol super -procedures. Bolh numerical 
and list-structured mfotmalion can be frtampylaled wil-b equal facility. Thus, tho LOGO systems 
prrirT-F’mmer ir, l-;v:d ol f-he recesuly o* re developing various fetilities already available in LlSP 
{lists, recursion, garbage collection, error service traps, interrupts). Us can concentrate on adddions 
[better error analysis) and modifications (pcdagOgica 1 simplifications) to L]$P. LLOGO undies language 
development across a broad spectrum ranging from PLANNER and CQNNlVfff through LfSP to LOGO. 

A second reason for this implementation «s to provide a natural transition to the mpr* 
powerful computational world OF LISP & c - the student grows more sophisticated. When desired, Ihe 
student has access to all of Ihe capabilities of LISP including: 

Arrays 

Fund ions of arbitrary number of inputs 

Functions that do net evaluate their inputs 

MICRO-PLANNER and CQNNtVER 

Interrupts 

L[$P COrnpilor 

Properly lists 

Floating point numbers 

Character display cursor manipulation 

Infinite precision fined point arithmetic 


Why Implement LCKHH in LISP 


Betlinh t 




LISP LOGO MEMO 


Fag* If 


March % 1975 


See [ton 2. Difference* between LOGO and USM 


The differences between LOGO amd LI5P can be described dn th*r bails of three educational 

goals: 

Simplicity ol both the computational and explanatory hind. 

Naluralness wherein the overhead For a naive user is minimized by following standard English 

■cqrwantionffi. 

Disparity which emphasizes the distinction between various modes such as defining versos 

running programs, 

it should be noted, however, that there can bo no One unique solution to the "best* 
educational language: These three goals can conflict. Furlhernriore, they cannot be so rrnphastaed 
that important ideas of computation are completely eliminated hom the language. For students ft! 
different backgrounds* simplicity and nalUtalr#s* may have very different meanings. Hdhee, 
alternatives to the particular choices made n designing CLOQO and ] [LOGO are also described, Thu 
section may be viswed as presenting a spectrum ol possibihtes From which $ tescher can build a 
computational world tailored to his own pedagogical purposes, 


2.1 Simplicity 
Lists versus Sentences 

Lists have a- simple recursive del ini Lion. A list is eMher 

1. iV/L, the empty list 

2. (word L word? . . .} , a sequence OF words <*■ a1oms) 

3. A list ol lists. 

This delinitio-n is confusing when Ihe sludent is still having trouble with the concepl of recursion, 
CLQGQ limils itself to list* built from cnly the first two of these Ihree ctauses, Such, lists are celled 
"spntbr»c=s“ 

AHerrative view: the concept ol recursion is tod important lb be eliminated Irom LOGO- 
Recursive programs are allowed- Educationally, the more examples of recursion available* 
the easier it is to understand. Hence, lists should be allowed, 

Computational power is not always in conflict with educational simplicity. !n addition to the 
standard list Operations of FJflST’ ifJ/HE!' end rttTfflUST (CM), LOGO provides TflST and 
liUTf./JSTr Furlhermore < all four ol Ihese operations work on words as well as sentences. The tact 
that word manipulation is mcn-e costly Ihan lisl manipulation tor LlGt 5 , Or lhal tskir»£ the I, AST oF a 
fist is more expensive then computing ils HftST is net of interest 1o the beginner, The natural 
symmetry of having alt of these operations is to be preferred. 

Alternative view-: LOGO introduces I wo data types - words and sentence*.. There is both 
an empty word and an empty sentence LESP’s world rs easier to understand. Tharp is 
only one type of data, s-expressions. Primitives like CAR are list operations onflys they do 
nOl operate ors words by manipulating She, word * 1 2 3 '? print name, as LOGO'S FfttST does. 








Repeatedly RUTf fFSTirtg ? sentence in LQG0 always term-nates In the empty list, tn LISP, 
'with rts more genera list structure feusli trom "croUfj-d pairs' and GOJVSir^j, Ihrs is not always so. The 
result is the possibility ol "shp-lhrough' bugs lor KMFTYP endtests of recursive procedures. Thus, 
LOGO eliminates a common source Ol error without significantly Hmiting computational power, 

Alternative view: Allowing an atom to be I he CDR of an s-expression sometimes allows for 
economy of storage. Also, the symmetry ol CAR and CftR in LJ$P make the data structure 
oesier to explain, all he ugh they are symmetric as list Operations only for the particular 
representation aF Irjt*. used ip LISP 

Rigid pfOgratn fortri 

LtSP allows program* fp be lists of any forme Editing and debugg-ng consequently become 
awkward due to the difficulty m naming pa^ts of Fhe program. LOGO simplifies program structure by 
requirung lhal a program be a series of numbered lines. The idcalions ot bugs and intended edits 
a r e then far ee$iar to describe. 

Criticism; LOGO violates Ihis assumption by allowing the user lo create linos Of unlimited 
complexity. It would be preferable to limit a line to a single top level cell. This does not 
prohibit nesting, » f undampnlel idea in computation. But il dees prohibit defeating Ihe 
entire pflin-1 ot line rumbers with such cade as: 

>10 FD 100 RT W T'D 100 RT VO , . , 

An alternative scheme mi£h( be- |p adopt a H OOT" li*;e convention. Lines are identified 
by flfts-ets from user defined focetion symbols. This has the advantage ot encouraging Ihe 
use ot rarvemorvic. names for portions of the user's program, rather than hne numbers, 
which hive no mnemonic value, while relain ng the virtue of having a name fo-r every part 
el the program. The user would not have to renumber lines il he wjnted to insert more 
tines between iwo lines OF code th-an (he difference between their line number*. 

Integer Arithmetic 

The initial CLQGO world limits the user to integer arithmetic. The rationale? behind this is to 
avoid the complexity ot decimal fractions. This is clearly a simplification whose value depends on Ihe 
background of Ihe students. 

Criticism; even for elementary school children, this siir’DliFication may cause confusion. 
k*asl beginners ere (routed with 
1 

— E U 
2 

Proponents pi fixed pOml arithmetic might reply that this is no worse than 
1 

— - 9-99999 
1 

However, a decimal printer can be clever in performing roundoff. 

Other allernalives are to hmil arithmetic to rational numbers, or fn use- the following 
LISP convention: Numbers are fixed point unless ending in a decimal traction. Operations 
only return fixed point if both operands are lined oOmt, 
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Anolher virtue cF Lj$P is Chat Fixed point numbers tan be inlinitely large. Arbitrary 
limitations due to Ihe frmte iiie of the computer*'* word do riot emit 1o confute (he beginoO'r. 

Conditicmats. 

LOGO allows the folFowing 5 ype of branching; 

> J 0 TEST pr ''rfirn re> 

I FTRUE 

>113 IF FALSE,.., 

TEST -sel 5 a Flag which subsequent IF TRUE'* and ITTAtSE 1 * access. This avoids the necessity of 
(fie efllire conditional appearing on a single line of the procedure. The sludenl has explicit rames in 
the form of line numbers for each branch, 


Criticism: This prevents nesting -ol conditionals. A second condition^ wipes Out Ihe results 
:j I Ehtf first, AKc, |hs $^opr of Ihe Mag set by a TICST ii unclear, tn LLOGQ, this flag, is e 
LISP variable, local to I he procedure in which the- TEST Occurs. 

LOGO'S lack of oarvnedl loops such at DO and MAP-CAR can be criticized as encouraging bad 
programming practice, such as excessive use df CO. This obscures the logical structure 0+ programs. 
AEso, it may be signiFicantty confusing la the beginner, and the source of many bugs. A child might 
understand auite well a control structure concept like H do 1 his part ot the program three limes", Or 
"do this part of the program fir each element ot the lisl", bul may be unable to Ooen-cide th*t 
control structure in lor ms Of jumps snd Conditional?, LOGO prpgr^m* tjrtf "pt-elly printed* to 
reveal their logical structure as can programs written in LISP or a black structured language. 


%'l Natu r alness 
Mnemonic Wames 

An obvious virtue if any computer language is 10 use procedure names whose English 
meaning suggests (heir purpose, Consequently, LISP 1 ? primitives and C/tfi *re renamed FIRST 
and RUTFIRST. 

Pfole: Everyone remembers hOw un-mruimOnic CAR and C£tW arc. However, most LISP 
primitives are named after Ihe r English counterparts. 

C LOCO synlav allow; Ihr i;sn 0 l certain. "nOiw wprda", wprds which appear ifi I he User’s 
code, bul have no effect beyond mating the code read more Uke English sentences. Fir exempli, In 
the I allowing lines of LOGO cade, the OR, THEN, and TO are permitted but serve no 

computational purpose They do not designate procedures, as is Ihe usual rase with wards not 
beginning with a colon, 


liVTH <prt<ficvl* t> APiO ^prwrffrfffe 
EITHER ■^rediVoli* t> OR c predicate I!> 
IF <]wnAif i ntr t> THEN , 

GO TO . 


However, as the student g;i n; mCire insight into LUGO, riOsse wQrd:; berime a burdeiV They 
complicate Ihe lask of |he parser, preventing ENs student From Feeling thal he really understands tlie 
language. Most ot the noise words hHve been eliminated in both 1HCQ0 and LISP LOGO. [LLOGO wilt 
tolerate THEN in conditionals, and TO in transfers, however, because they are so commonly used.] 




Matching English vocabulary to computer funetiens can be difficult. Ene1i?h words, finely 
have a i.ftgto rueanmg. Following ere examptec where CLOGO may have m,de Ihe wron a choice! 

L CLOGO use* f£ mskacf of EQUAL for its equality predicate. The rahOnate is that /S will tie rrore 
laminar fo a non-mat hemebcal beginner. However, Ihe omnrprese-it nalur* ot this Fnalisb verb 
results in such LOGO code as: 

TEST JS .TIHSMVHnKH GMATERP ;T!lAT.NUMMR 

thus^ it mi Rill be belter Ibr LOGO to use EQUAI^ 

t. Another example where LOGO may have chosen the wrong word is in defining procedures. Tte 5 is 


TO PftOCBDVMStf/lliE ilNPUft INPUTS „, ,. 

The English word h to" can imply execuhorx For example, 'he is 1o run hie program - A belter choice 
would be "define - . 

Parsing 


LISP avoids the necessity of parsing through the use of parentheses. This might be 
considered well worth emulating m LOGO lor its explanatory simplicity. However, simplicity most be 
contrasted with naturalness. A beginner |$ used Id ustng English whet# „ Br bs end modifiers are 
connected by gtammar,, context and meaning rather than explicit parenthesi^mg. This naturalness 
can bo preserved to- procedures thj| take a fixed number Of inputs. This allows such lines of code 
to be understood by anyone wilhout any special programming knowledge. 

fflfttF/IWfJ KW RFC If T PO 

Thus r a beginner can ox-press himself with no extra burden of parenthesising when his pretrem are 
still very simple. 

Parsing can be used 1o permit infix nolatidn. Again il | 5 simpler to demand that ill 
func-liijnal cals bo in preliv notalipn. However, a beginner is far mo-re Familiar with FORWARD 
:Srm\ia than with (FORWARD fSUM Jim 

Eventually, as one’s cede becomes more complex, parentheses become a simplifying tool 
One does not h*y* ta guess how 'h» parser will work. LLOQQ allows this. 3f desired, parent'hetet 
are permitted and interpreted in ihe standard way. 

Criticism: LOGO complicates ids parsing algorithm in several ways, making 1} difficult to 
explain to a student. For example, the language does: not insist that all primitives tatu? a 
fixed number of Inputs. In sbme cases such as the title tines OF definitions, (hit is 
i easohable. On the other hand, it is somewhat confusing tp limit such primitives as WJW to 
bnly 2 inputs if not parenthesized but any number OF inputs it parenthesized. Equally bed 
rs the fact that primitives like LlLOKTs PRINTOUT lor printing definitions do n&t 
Evaluate their inputs It would h# mpr# consisted for 

PRINTOUT "PROGRAM' 

to b# required. 
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?.S Disij aHtjr 

program Versus Gala 

Bolh programs and d*l* are information struclur**, The ditFerunee between, the two is 
fiolely 3 matter of use LISP ft reserves this elegant view by aHowmg programs to bB passed as inpul 
and, indeed, to even regime themsalviS, This cower, for all Us simplicity, can confuse the beginner. 
For the novice. The difference between detming *nd running a procedure is unclear. LOGO provides 
clarification by forcing a complete distinction between It* processes 01 cfef.nlng and 0 -F -evaluation, 

Ctrtioism: LOGO violates this idea, A. progr 3 m can he executed mside a definition if not 
preceded by a line number. This is a intake. The typi-tal case is lor the user to have 
intended to type the fine number. In its wistful desire lor more computational power, 

LOGO has forgo I Sen its epistemologicst loundaliOns. 

Homonyms 

LISP has the ability for a word to be th* name of both * procedure and a variable. The 
position of I he word in a list then determines how it is used. Homonyms, however, can bo confusing 
should a word which is bolh 9 procedure and a vanable be lieated when it is Ihe first element 
in a list? The choice is arbitrary. 

LOGO prevents such homonyms. Words evaluate as variables only when preceded by - , 

. r r X - - causes X lo evaluate as a procedure call. 

, , . iX - - relurns the value 1he var iabte X. 

|h i.is, LOGO and LISP share Ihe power of allowing any string Of loiters lo be either * procedure Cf a 
variable name. But LOGO insists on an unambiguous "Ideal" distinction,, independent of posi1ion f 
between these two uses. 

Another or ample ot the cfever ways LISP takes advantage of homonyms is NIL LISP u=*s 
this word to name bolh the empty list and the logical Irulh value This can result In more 

cm Gnomical procedures, The convenience however, has no conceptual basis. Hence, i| can contuse 
the user who does not yet understand ether fist manipulation or logical analysis well. 7h»S is similar 
to the situation in A P L. where the logical constants are the integer* 0 and 1, and condiliooals Are 
accomplished by numerical manipulation. El tan lead (0 Obscuring the purpose pt b given piece of 
code, 

Line Oriented input 

L3S-P evaluates an expression when parentheses balance. Thus it c-armct catch errors caused 
by typing top many right parentheses. LOGO waits For a carnage return, Tfence it is capable of 
rscOgnlllng this problem- Furthermore, a user can write several calls on a hne. Execution is de ayed 
until "a carriage return te typed This has Ihe vxrlye ol separating the tasks ot terming grammatical 
expressions from executing programs. 



Section 3. Q'Vf fvi'eifr of [tic I m pic mentation 


LlSf LOGO it designed sd IhaH Ihe user 1 ne^d never know that he is comnnjhPc.s|ir»g with 
otf«r than a standard LOGO. However, If desired, he can insect- parenthesised LISP code anywhere 
in his LOGO program. 

LISP LOGO is basically a compiler, it converts LOGO inpul to LISP programs. The result is 
Ihat running. most procedures lakes less time since the code *eed nol be reputedly interned and 
parsed. 


The following pages provide an overview of tho major parts o( Ihe system. These *tb Us 
r*arfer, parser, evaluator,, printer, and pn-er handler. More detailed explari aliens ol Ihese will lolfow 
in laler sec lions of this memo, For imptemenlation details, LISP LOGO is available in well-commented 
interpretive c-Ode. 

Code tor the LOGO chspLay turtle is d-scussed in Section iS and Sbcli&n 17, and code for Ihe 
mu£k boy in Sec lion It. The "LOGO prQpeef is concerned with more 1h*n the development of a 
computer language, Of major interest is the design of vgnous computer'driven devices which 
provide a rich problem solving environment lor the student. However, special purpose primitives for 
driving these devices a'® indeoendenl; of LOGO versus LISP issues and must be added individually. A 
LISP-basert implementation does have one special virtue. Tor those devices like the music box which 
are driven by ASCII characters, Ihe primitives can be written in LISP Or LOGO and then compiled. It 
is mot necessary to create code at the machine level. 


3LI Reader 


The LOGO reader is basically a line oriented LISP reader, [| returns a fist Of atoms read 
belween carriage returns. The fundamental tasks Ot interning aloms and building lr$t structure are 
handled by USP. Conflicts in character syntax and Identifiers belween LISP and LOGO present the 
Only subtfeties. 

Certain characters such as the nhx operators ±, »nd / do not require spaces to be set 
oil as atoms. This is equivalent to being * "single character object" in LISP. Other characters such 
as in. dotted pairs are special in LISP but not in LOGO- The solution to these conflicts is Found in 
usirg separate ■>eadtable"s for LOGO ard LlSP- 

Conliicts in names also occur. The LOGO u«r has. access to all Ihe ordinary LISP 
procedures, but must be prevented from access-ng LESP procedures which are internal to ILQGO. 
Th-s is accomplished by using fwO ^Jb-arreya*. When the user types in an idenlilier with the same 
n*me as an internal procedure, he accesses a different atom. 

MACLISP allows any number bt separate h readtahle"s and "ob#rray"s. This permits multiple 
worlds - PLAWJER, COAMVER. LISP, LOGO - Id co-exist wilh no conflict. Switching worlds it 
computationally fast, All that is necessary is to rebind Ihe flEVl DTARLE and ORARRAY variables to 
thi? desired world. On the other hand, the naive ■u$S ir is prelected completely from other 
environments and need not even know of their existence. 


Overview »f the Implementation 


Sectbce 3.] 
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3J Falser 

The- parser converts ? tOGO line to Irel-structured Taim. this, requites lhal information on 
the number of inputs used by a prOct**r« be available, [ns-erling parentheses is a trivial 
computation for procedures with a frxed number ot inputs. However f comple-dlies are introduced 
into the LOGO parser by: 

I, Having inti* as wtH as preFi* Operators. 

£. Changing, Ihe number of inputs dependhng upon whether Ihe user embedded the form in 
parentheses (SO'M, SENTENCE, ,-)• 

3. Primitives like TfJ that do no! parse their input, 

d. Homonyms: Fund ions which have the same name in LISP and LOCO, but have diFIcrcnt meanings. 
These sro handled by having Ihe parser delect Ihp nines of LOGO primitives which conflict wilh 
LISP, and convert them to functions wilh efferent names ihat do not conflict. 

This makes the par Mr Ihe most comply ?1«d pari d 1 the timulalion- 

ParsinR information is sfored on Ihe properly fist of a I unction. The major sub-procedures 
arc contprned wilh preli*, infiy, and user-typed parentheses. Special prunitives ere parsed by 
storing a procedure as the parsing pruporty. 


3.3 F.valuation 

The basic lOGO functions thjl do the user's computation - i.e. Ihe arilhmcbc, list, and logical 
primitives - are the simolesf pad {if Ihe simul alien. These tunc I ions all Occur in LISP, usua'ly in a- 
somewhat more general form. Hence, this pari of the implementation is iitlle more than renaming. 
For many pnmilivps,. LLOGO provides more argument type checking anti informative error messages 
than are supplied by their LISP counterparts. 

Farmed cube is emeculed dircclly by Ihe LISP equator. Indeed, a user-defined program In 
parsed form is simply a LIS-P PFfiQ. The line numbers are lags in Ihe PfiOG- 


LOGO procedures could be represented as list* cl u”parsed lioes- internally. In Ibis case, a 
line musl bo interned and parsed c 3 <h lime il is run. Ita-wever, Ihe problems of printing the 
definition and editing a luncTiQn a-re simplified, the infernal formal is idenlicsl to the lormal in which 
the user originally lyped the expression. 


An alternative solution is to represent LOGO programs in parsed, i.e. LISP Form. A LOGO 
program internally is a LISP prn^ran. This maximizes run time speed and simjphliM budding program 
underslarvder?, |t hu the disadvanlagt; of complicating Ihe Parser and Ihe printer. 


[ The parser mu^t handle 1unct«0hS that have nol yet been defined. This can be accomplished, 
however, by reverting to the solution of parsing at run lime those lines which conlain unknown 
(umti&na. This run-lime parsing can alter the program's dsFinilien 35 well so. it only need occur once. 

2, Prioling definitions and editing Imes requires an inverse parser or "ueparser" which returns the 



U&P-ifitfd code to its original form, This is possible providing there is no information lost in parsing. 
Such is the case it the parser makes special prov L sion tor distinguishing user-typed parentheses 
front parser-g .0 no rated parentheses One way to uccbipplish this is by beginning, user -lists with a 
do-not lung 1 unction URFK-P AR F.'.A' del red as- 

tmvN vstm-PMiffl fxt x) 

3, Editing title tines is made mpre complex, ]t the number of inputs accepted by a Function is altered 
by editing the title line, the editor must reoarse the li'ws ot super-procedures in which a call tb the 
the nHilpH function appears. This can fae accomplished by maintaining a super-procedure tree, 
although LLODQ does rot currently do this, 

These complicalions can be avoided by stdnng both representations df the prottduhb, This 
is an e*ce!lent trample of a space versus complexly (tfcde-crf. LE&P LOGO currently does no! store 
both representations. 


3.5 Error Anaty^is 

Since LOGO >s a iangua&o which is designed to be used by beginning programmers,, it is 
important to provide informative error message?. Consequently, all LO&0 primitives do entehSive 
typo checking on them inputs, I.LOCO will try lo prml out the torm which caused the error, and give 
the line number if the error occurred inside a procedure. Afler a sirpolc mistyping error which can 
be delected by the parser., the user is given an immediate opportunity to correct the tine. For run 
(■imp orrors, he is grvfrn the option of causing breakpoints. Facilities tor eirplcrirrg the stack from 
inside a breakpoint tOOp a^e avai!ab3e. Since LOGO procedures are represented internally as Ll5P 
procedures, the standard LISP TH/iCF, package can be used. 

These facilities am implnmtnled using LISP error interrupt handlers and Et'/llrFMME, Th* 
sophisticated user desiring customized error handlers can access the USP facilities d«rectly. 


Overview el ihe tmptwncfitahwi 
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Section 4. Performance 


4 3 Sii<? 


LISP 

LLOGO (compiled) 


Total spate 


2& Bocks (1024 36 bil wwdsf 
S Binary program 
S LrSl structure 
4 ^lumbers, Alomic symbols-, ate. 
43 


these figures do no! include space for user programs* or loading Ihe display turtle, music* 
or GLRMlM'JD packages, Bek wren S and 3 OK beypnd the amount of storage mcntioncdl above would 
provide a reasonable amount of workspace for user programs and data; this would correspond 
roughly to programs of perhaps a few pages. The figures above are for tire ]TS Implementation! on 
DEC 10 systems, it Occupies slightly less space, In the current MACLISP, storage expands as needed, 
LLOGO takes advantage ot this feature — If programs grow beyond a certain size the user is asked 
■whether he wishes the allocation, te bo increased. Storage is expanded eulOmalicaUy dn loading 
special packages such as the d-splay turtle. Of Ihe 17 blocks which comprise lha LLOGO system, all 
but 3 Ore pure, and CAr, he *frl*r«f Among users, 


4,2 Computation Time 

For mosl processing, LLQGQ enjoys a speed-up over CLOGO and 11 LOGO due to Ihe fact 
that parking and interning -occur only -ante at -delme time Further, HQOQ makes it possible to 
compile LOGO source programs into machine cede using (he- MACLISP compiler F&r increased 
efficiency [See Sec I ion 9J. Workspaces can be stored on the disk in internal LISP format. (See 
Section 30.1] Consequently, te-reading files has no overhead. CLQGO has an advantage, however, 
in manipulating w&rds* as its internal data structure is siring, rather than ksl Oriented. 


4.3 Lise 

Almost atl of the primitives of CLOG) and 11L0QQ, (including the music bos and display 
turtle]! Are Implem^ntrjd. Hrnc[, LISP LOGO Is capable ot rpad'ng, parsing, and running most fries 
saved under CLOGO or 13LOGO [perhaps necessilating minor madilicalion]. 

It can also be used real lime by an individual 1am*liar only with LOGO: no knowledge df LISP 
is required. On Ihe other hand, all of L IJP's facilities are availably. Programs sari be written in LISP, 
Or in machine language using LAP, and made callable FrOn LOGO. The special packages fbr the 

display turlle, muite box Arid G0HMLAND tun ;i sO t:.[,:C f r *rr iin Ordinary LISP, without ttte f£et OF 

the LOGO environment. Some other facilities ot LLOGO, such as the breakpoint and stack 
manipulating (unctions, ace also available fbr use in LJ$P. LISP users can take advantage bf these 
facilitim; without inter action with I 0G(| pimply 1>y loading llm appropriate ti'p*. cf I ISP Functions. 


11 Availability 


The 'nnplerrenlalien is written completely in interpretive code. It runs compiled uhdbt the 
MACLISP Currently in use at thg Artificial Intelligence Leberalory. L5.000 has also boon implemented 
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cm tlandard DEG POP-IQ's under the TEfi5Q and TEiO systems, and or. UULllCS, These 
mentations are discussed in Seel ion 12 and Section L3 cH this mrrnc. 
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Section^ 5. GEtling Started 


[n, the Following feci ions, we will go info mpre del ail concerning Ihe implementation &F LISP 
LOGO, and prevrde some practical inlormalion lor using iF. We will ra>t attempt So p^avjtJe Ihe reader 
wilh an inkoduclion to Ihe LOGO language! several excel lenl sources lor this already exist,, such aft 
the LOGO Primer, end tin? ] ILOGO lifer’s manual [LQQQ memo 7], We will assume 1 hjil the reader has 
tead these, or is already familiar with CLQGQ dr i 1LOGO, Ihe Qlher itnplemenlaFiorYs of the LOGO 
language available al the At lab. Enfield, we will concentrate on pointing out differences between 
LLQGO and other implementations of L0GQ„ and describing features unique to dvr implement alien. It 
is nol neceff ary to know LISP Fo understand moftF of what fallows, although some Knowledge- of LESP 
would be helpful in gaining insighi into Ihe impltrmentalien, For more information on LISP, see Ihe 
MACLISP Preference k'faingjl fay Dave Moon, and Ihe Enterim LISP User's Gude (A-E memo L90] by Jon 
L White. 


Nolalional convenliOns: Throughpuf (his tnetno, [/SfiP TTFEJiV and LOCO CUfifi letlf 
oppmir in (1 font liir Chejs. AttRREVI/ITfONS /itr t.QCti primitive* trifj he npleJ in ArdcCJ { j. 
SYSTEM TYFEDUT will appear in a fnul like this Control characters are denoted by a followed fay the 
character. You type a control character by holding down (he key marked "control" while you ere 
typing the character, iust faKo you would use the "shift" Key to type a capilal letlcr I meant escape 
or altmode, not boUar-sign, excepl whe j e otherwise noted, Angte brackets < > mean something Of the 
appropriate typo sus&kkTci:! within the brackets; for instance, if yOur user name it HENRY, Ajser 
namei means your user name, eg. HENRY. Except for control: characters, which usually take 
immediate: effect, and except where otherwise noted, end ell Imps pi lypein willi a carriage relurn. 


The following procedure is intended to help very naive users &r ITS lo get lof.ged in, and 10 
obtain LISP LOGO- See AS memo £15 r How To Gel On the System, (or more del ails. 

1. Find a free console. It it is a TV console, lurn M bn using the swilch on the gray bon mounted On 
the wall, El should Tiber# the names of a ! l the users currentry On the system, Qlher types oF consoles 
will show the message. 


Al STS ^vcrsiwrP CONSOLE ^number:- FPjEE, <tim*>. 


Z, A console which is Free understands pnly one command, AjJ. [on TV terminals, use the key rnarkfld 
CALL, The computer will respond with the following messages: 

M ETS cversimn^, I1RT ^VJfliuriL 
<-number> UtlERj. 

<hews> 

3. When il stops prlnlmg, login ?s Follow*: type 

]f there are any messages for you, 


-MAIL- 




will be printed. You can typ* a spat* le receive il or any other character to postpone it. A * will be 
lypnt) si the end. 

4 Mow you have completed logging in 1o thin A1 syslem. To pel LLOGO started. 

5. Decide which version of LISP LOGO ybu want. Choose from: 

LLOGO - Standard version Of LESP LOGO. Vocabulary is compatible with I1LOQO. Section 11 contains 
a delated comparison of this versron pi (.LOGO wilh 13LQC0. 

CLLOGO - A version which uses a v-o<..aL:;jlary which ts compel ible with CLOQQ. 

NLLQGO -The vary falesl version of L. 1 SP LOGO- Thi* is erp^-Hmontai, 5.0 we make no promises. 

When you de-cido wh«h you want, type 

e/ proa-mm 51 

I or c* ample, tU.OCO . 


6. Then LLOGO will print Oul some inilial messages, including its version ityrnbcr and LlSP'o. LLOGO 
h ?3 available several packages ol special function*, *n<J you witl be asked which of these you are 
going Id use. If you #fe *1 TV condyle, the Fir si question will be 

DO tDU WANT TD USE THE TV TURTLE? 

[f you want !□ ut* th* turtle commands 10 display p clures on your terminal, you should answer 
YKS. Vdu should also answer V FS H you intend (0 dpfirw pr edil a procedure containing such 
commands, even if you don’t run the- procedure. See Section 17 for del ails on the TV turtle, if you 
ire not logged in al a TV lerminal, you can use the turtle on (he 3^0 Or DT^Q displays instead. 
LLOGO will ask 

DO roil WANT TO USE THE DISPLAY TURTLE? 

If you answer V£S, it will then ask which display you want 1o use- It Is not ne-cesssry |Kali you 
have the 3A0 display scope, the PPPt. or Ihp G'4-13 display. Id do just deF j mng and editing. You can 
svtri run the procedure it you do not mind not being *hle to ih what the procedure does. See 

Section 35 for more information. 

DERM LAND 5 

If you want to play with KRWLANO. the display turlle for character displays such as OATAPQINT 
terminal?, aoswer ¥ES. This has a prompter which w II run some demonstration* end provide help d 
you need it. A^aln, il you intend to deline Or edit procedures designed to run in GFRMLAND, you 
must answer YES. See Section ] 4 

MUSIC SDK? 

IF you want to use LLQGQ music box primitives, answer Thi* will inquire further, to which 

music bo*, PtO, Spe Section lb, In case yOu have answered YES to any of these questions you 
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hsvc 1o wait (nr a white. because <1 take* surra lime 1 a load in tha fifes, H you ward la interrupt 
loading in type n. X , fiol At”. IF you cbanae yOtF mind about wanting any of the subsystems 
mentioned above, y&g <ao fto through the initial questionnaire again by <alHng the function 
/il.UTC/lTOR. IF yoo have a Jilc named UjOCQ (I NIT) on your di rad Dry or there is a file named 
■=ufrr JJ.OCO, on the f JiVfT.J directory, LLOGO will read il as aft initial iral ion file, ewecUtiryg 

LOGO coda contained therein. When all 1hi« Is finished, UQQO will indicate He readiness with 

LLffiJO LISTENING 

? 

7. It you find yourself in the unlorlunale siluatiOn ot meeling a bug in LISP LOGO, you may report il 
hy using I ha function HUG- The mpul 10 BVG should be a message describing the difficulty, enclosed 
in dollar signs. For b* ample, 

BUC S 

TIf R TURTLE ESCAPED FROM THE 

DISPLAY SCREEN,** 

1 

■,THANK TOU POFl YOUR PATIENCE 


8. Voy can logout when you are finished by lyping GOODBYE to LOGO- The terminal should then 
say, 


AND A PLEASANT DAY TO YOU! 

Al ITS * version 5, CONSOLE ■churntnr?- FREE slime* 


tj, Haue (uftt 


Section ft. Pursiinj; LOGO 


THtj section will discuss a few of t^e more complex issues. in parsing LOGO into LtSP„ and 
discuss how they ace handled by LLOGO- LISP is tend at to parse, as ils syntax is totally 
unambiguous. The .-implication oF a- function 1o its inpuls always happens in prefix notation, »nd the 
precise syntactic e-sclent of a form is always clea-iy cleli'-je.iii-ri hy parentheses, LOGO syntax affords 
the beginning programmer some conveniences over U5P synlax, while retaining much of the 
expressive power Of LlSP., Parentheses can be omilfect surrounding every Form, and the more 
cuslomary inf in notalion for arithmetic expressions can be arbilrarily intermingled with -prefix 
nolalion. These conveniences aro bought af the cost Ql complicating the parser, aid introducing some 
cases, where arnb'guily resulls regarding the user's ntenf (or some of the larger age’s syntactic 
cooslrucfs. 


6.1 Infi x Fspressjojis 


LLOGO allows infix rotalion to be used as well as prefix fundions in arithmetic expressions. 
Most LOGO arithmetic functions exists in both prefix and infix flavors, and the user is free to use 
whichever he desires. 


FEINT FIRST :X DIFFERENCE 1 

is the samp as 

PRINT (TIMES .1 *MG XPT ;/} ((FIRST :Xfr (TIMES ,-G 17 hil) 

LLOGO observes the usua' precedence and associativity OF arithmetic operators. 

hJofe that a complication of the LOGO syntax »t that alt furttlions, ndt just infix operators, 
are required (0 have precedence levels, ts 

FIRST A t 17 

the same as 

TIMES (FIRST:Ai 17 or FIRST (TIMES :A 17} ? 

The situation is further complicated by the user's probable cxpectalion that luncliOns which 
manipulate logical values have lower precedence than comparison operators fihe <, > and =. So, 

TEST :NtJMHER < -.PI 

i$ taken to mean, 

TEST (LKSSP :NUMBER .PI) *nd nor L¥£SP (.TEST iNUMRER) tFl 

CLOGO gives ail arithmetic operators I he same precedence an the grounds that precedence 
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would be rfiliicull lo pxpla-in- deafly 1o children, Ito-we-ver,, this has Ihe drawback o* deviating fi-cji-n- 
the customary mathematical convention, S-mcu the molivatwn lor introducing inii* relation inlo LOGO 
syntjur ■$ so that arithmetic expressions cam be written in lbs mfrx Fd«rm in common use, ILOQO has 
been designed to obey the usual precedence convention*. 

LLOGD tries to please everybody. ]f you feel that (he precedence scheme which has been 
implemented does not agrre with your intuilion, you are tree to redefine the precedence levels as 
yog wish. LLOGO also provides Ihe capability of defining now infix operators. 

The initial default precedence? are identical to those OF 11L0QQ and are as Follows: 

700: a [exponentialion] 

600: * - [prnlixj 

500: ^ \ 

flOO: * - [infix] 

300: [defaull orecedencs for system end user Function? J 

200: < > -r 

100: fF SOT NOTH EITHER AND OR TEST 
50: - [.if AKE] 

Initially, operators of levels 50 and 7M art right associative, and the rest are lart 
assderative, which s the default. Logical functions should have precedence tower than comparison 
operator?, so if Ihe user deFmes a tog.cal lunctign he should set the precedence himself otherwise it 
will receive the default precedence. The user can change 1 hingy by Using fho following fund ions: 

PRECEDENCE 'op- 

Retgrns the precedence level of <up>. 

PRECEDENCE 'op* *I&i< irl* 

Sets precedence level to Ihe speeded <(?!*(*, which may either be a dLnnber, pr 

another opera lor,, which meant Hint is Id be given the same precedence a? that Operator". 

PRECEDENCE Nil. <lrrrl> 

Sets the tMauH precedence for funclions 1o <lrvr.i>, All functions which are not in the 
shove list Of infix lurcfions, or have not boon assigned a precedence by the usef, receive the 
default precedence. 

f'tSSOCI/tTE <ichlr.h -tray*- 

Declares 1 hat all fgn*1i(jns pf precedence level will associate * whirA-ieayt» p which 

■s either 'LEFT or 'RIGHT. 

/ si t x 

Defines to be an infix operator of precedence <hwel\ Specilymg a precedence Is 

Optional. 


NQPRECEUENCE 


Fortes all infix operators tu the same p r eredence tevet [Shis writ be higher than the def#ull 
prfrtedencoj Makes LISP LOGO look like CLOGO [well, a!moil...} 

iINFIX 


This vansblo cdnlsins a lilt of all current mFin operators. Look, but cton’t touch. Usfr INFIX 
Id add new inlix operators. 


6.? M in us Sign 

There is some ambiguity in the handling of minus Si|jn. For nv.nmplc, consider 

(SENTENCH .1 

If the rmrtLK sign is inlerprelcd 3s an inlix dHFerence operator* 1 hit will result in 4 list of one 
elnmc-nt. 1l the minus sign is inlerpreled as prefi* negation, it will result in a list of two elements. 
CLOGO uses the spates in the line tp divamh yjiata this case, |F (here is a space between the minus 
sign and the ;fl, it is interpreted as intix, Otherwise, it is interpreted as prefix. In 3 I LOGO, spates 
are no! semanlically significant except to delimit words, so Ihis is interpreted as (SENTENCE 
(DIF FERF.NCE T \/\}) regardless OF Ihe occurrence 0* spaces. LLOGO treats minus sign as does 
11 LOGO. Or-e would obtain the result of the a I her interpretation by using 

(SENTENCE 3 

The preceding discussion applies only to the parsing of infix expressions. $0, [-+] is a tist or 
One element, a negative number, but [- 4] is a list ol !wd elements, minus sign and 4. 


£3 Homonyms 

LLOGO makes all the functions at LISP diredly tttessiblfr to (he LOGO user, in exactly the 
same way as LOGO primitives. Th s runs into difficulty when a L3SP function and a LOGO function 
have Ihe same rarne but diflerenl meanings. These are currently handled by the darner, which 
confer Is them into innocuous atoms which do net conflict with LISP, end are reconverted upon 
un par sing. Currently the following functions are homonyms: 

PEI NT, H/im JOir, LWT, EDIT, [also SAVE m the MUl.TJCS version] 

When the user types in one ot these, it Is converted hy the parser to an internal representation 
consisting OF a different Function name [tjfKXhPRfNT. WQft'L/lST MGQ-EBiT IfiCO-NA.WDOM or 
i.fJGfl-.S/PI'f’, as appropriate] When the user requests that the line ho printed Out Or edited the 
unparspr converts it back to the way it was Originally typed in. ]n th? CLOGO compatible version of 
LLOGO, when XlAREFI!L is not set to Nil. the following primitives which conflict with CLOGO arc 
also changed by Ihe parser; UST is changed to JPtf INTOt T. m$Pf.f\¥ fc S TARTMSPL/ff* CRT 
ancf WErlt) to HE/)t)FILH t and Dfl 10 RUN. Warning messages are also printed in these cases. 

There is one pitFaH in Ihe current melhod oi handling homonyms: sometimes, as with passing 
functional arguments, the parser does not get a chance to do ils thing, so Ihe user rr»y find an 
unexpected function called; J..IK" 'PRINT - .calls LfS-P's PRINT Fund ion, nol LOGO’S-. 
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6-4 Abbreviation! 


Abbreviations are kc ompliEhed irr LLjOGG by cutting the name of the function whieb u 
abbreviated bn the properly list of the- abbreviation as an pfPR &r FEKPfi property, as appropriate, 
Abbreviations are expanded into their lull form on parsing, and are telt that way. The user has the 
capability o 1 crealing new abbreviations by 

ABHRMIATR *nrv mm** *#td mm*> {rflf) 

and erasing them by 

ERASE AHHRWI/iriON *ncm*> 

ABHREVtflTK evaluates its inputs, but F.RASE doesn’t. A complete listing of abbreviation;, and I he 
names of procedure; abbreviated by them, can be Obtained by domg 


PR INTQUT A ft im V f ATf OSS 
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LOGO, when the user defines a procedure using TO, CM EB/Fs a procedure he h» s 
previously defined, LOGO enters an “edit mode* where met beginning wilh a number ar> inserlecf 
mlo the procedure under modification. LOGO prompt* wilh V" ml her [han h ?” la indicate 1hi&. The 
intent ol having a separate mode for etl«t ng procedure s is lo stress I he distinction bei W e erl defining 
procedures and executing Ihem. This rts I incline is r»oF strictly maintained: if Ihe line does nol begin 
w " h 3 lumber, the cpmmards are erected as Ihey would be ordinarily, with a few exceptions [Ihd 
user .£ prevented From doing another TO or EDI r for instance] Occasionally, this Feads to errors, 
(■Or instarH* If Ihe user forgol to type the line number al the beginning 01 a line interred ip r 
inner 1 ion. 


The default slate oF LLQQQ it to rclam thg separation al e-dit mode fratn ordinary mode at 
m 11 LOGO and CtOGO. The slightly more sophisticated mar, however, mijht lind himself in art 
unnecessary loop of continually typing EDIT s and END' s while working on the same procedure. 
Since the lines typed 1 by Ihe user ftp insertion into a prgcedu'c are inserted immediately when the 
user finishes typing the line, END dues rpF cause anything fa happen olher than the termmalicn of 
edit mode. The system always remembers the name pi Ihe last Function mentioned by TO, EDIT* 
FH INTt U‘l , etc. as a default for these functions, sa whnn working on 3 single lundion, EDIT serves 
only Fp enter edit modn The user has an option pF turning off the separate edd mode toy setting ihe 
variable :EDITMOOE lo NIL This will cause lines beginning with a number to top inserted into Ihe 
default procedure al any iim? In ihis mode, it is never necessary to use END, and EDIT will only 
change Ihe name ol the do Fault procedure af given an input. The prompter will not be changed 1 . 

In LLOQ0, iF is not necessary 1o be in edit mode to use F, DITUNE Or EDITT1TI E on & line 
*f the deterd! procedure, and the editing control characters are available even when not in edit 
mode. 


7 J Con trot Character Editing 

LLGGO has a control -character line editor similar to those in CtOGO and 11 LOGO. This makes ' 
11 particularly convenient to correct minor typing errors, by providing a means of recycling, portions 
of the him typed previously, m^Fpprf oF requiring retyping ol the entire hne. Tin? reader keeps track, 
ol IwO' lines: an old line which you are editing, and a new tine, which LLGGO is to use as the next line 
of input The old line is always (he Iasi line- you typed at LL0G0, estepl immediately after a parsing 
error, when Ihe ofFending line will be 1yDed out al you, and il may be edited- Vou can also set lha 
Old lire you* Self to be a lire in Ihe current default procedure by doing EDITLINE <Iinr. numier>, Or 
H-ir: I lie of a procedure by calling EDITTITI,E, Everylhing you lypa gTter the prompter, or esust to 
appear using the control characters, is included in Fhe new lin@, uni il you type cerclage return, which 
terminates ed-ling for that lire. Fou may use Parts of the old line in constructing the new lime by 
using, the fallowing commands: 


AE 


Get the next word from Fhe ii-prd pF the old Ime, and pub il on the end oF the new tine. 


Grtininrj anil EdLtin^ Ftinclirms 


Serfirn 7.1 





LISP LKSU MF.Mn 


Fills 28 


Man'll 4, 1375 




Put the resF oF the did hnc at the- cud of Ihe new I me. This Is UK-e doing hK’s unlit there -is 
nothing le^t in the old line, 


AS 


Delete a word from Ihe honl of the old line. 




Delete a word from Ihe md of Ihe new line. Like rutaOut, except rubs nut a word Instead dF 
a -character, 

LLOGO Uses different characters lhan 11 LOGO and dOQD do because LISP uses most Of the 
control characters For interrupts and i/o. 

The L'.OCO lop level loop keeps a record ol recent interactions with Ihe user. The following 
functions arc uselyt -in referring bach to a previously typed in line, Or previously produced value 
wilhaut relyping it. 


LASTVAWK <n* 


Wilhout an input, UlSJlfAttlR returns the iasl value typed out by the top level loop. This 
Is like Ihe variable * in LISP, An input of <n> lo UI&TYAUJSt returns the <n>\h previous vifut, 

l/ISTFORM *tt-' 

L/ISTFORM t cl urns the rttosl recently typed fo»es like the variable * in LLS-P. An input can 
specify Ihe *n>Vh mosl recent Form. tWAL MSTFORH executes Ihe last forth over again, 

TiHS FORM 

Like LASTFQftM 0, this returns Ihe Form in which it 1$ contained, like the variable - in U&P. 
L/lSTUttE<n> [IUNS] 

Returns Ihe last for <n>th] previous I me. MIN LASTMNF. eretules the last line again. Nole 
that a line may contain more lhan One torm. 

HISTORY <n' 

Sets the number of interecliOns remembered by LL-QGO to Tnpuls In LIt$TVALUR r 
L/iSTI4NK r and tA$TFOR if must be loss than this number, which can be examined as the value oF 
the veriablo jf/TSTOWT, and is initially setlo 5- 


7,2 Printing Functi on Definitions 

The function PRINTOUT can bo used to look at definitions of user procedures. In addition, 
it has other options tor oxaminphE the state oF your LLOQ0. PRINTOUT doesn’t evalualc Its inputs. 




PRINTOUT Affixed or 

Will prml cm! th# defiriifion -at Ihe spec f Ad procedure. If Ihe rare is c mil led, it wilt 
assume fhe- last function that was defined, ediled.or prinLed. 

PRINTOUT LINE 

Frinfs out only the specified I ne ir> the deleull procedure, 

PRINTOUT TITI.E [POT] 

Prints (lie just t?ie tulle of the procedure gr*en. If Ihe input is omitted, prinls the tills Of 
the current default procedure This Is useful if you forget which procedure is the default. 

printout titi.es {puts) 

Prints the lilies ot all cu'renl user procedures Ignores buried procedures Iseo Section 

10-4 

PRINTOUT PROCEDURES |PI7PR} 

Prints out Ihe delinitigns ol alf currently defined user procedures. WiH not print the 
deli nil in ns oF procedures thal are buried [see SerbOn 10.L], 

P RINTOUT TV/l M ES t PUN} 

Prints the names and values fll all user variables. 

PRINTOUT /ILL JPfl/JI 

Ctoes PRINTOUT PROCEDURES -and PRINTOUT NAVES. Another uselut command is 
LINE PRINT, which causes a listing, similar to the output of PflfJflWT flLt^ to appear on the line 
printer. It takes an optional input, 9 word tn be used as a title In name Ihe listing generated, 

PRINTOUT SNAPS 

Pn-nfs a b&t 01 saved drsplfcy turtle Scenes. See Section 15.11. 

PRINTOUT FILE 

PRINTOUT INDEX 

Set Section 10,2, 

PRINTOUT AUBREYf/JTIONS 

Priptj a list ol ell current abbreviations, and the names of Ihe procedures which each 
abbreviates. 
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PfflMlJt/r PRIMITIVES 

Prints a qOmpIrli: list of .ill LLQGO primitives. 


The command, fZRASE ■will remove unwanlsd portions ol your LOGO. Ihe Ihptite (a 
arc nut evalualed. The options ev*iil;qblc arc: 


ERASE < fjrnrrtliirr.. iarinf\(r nr innp irarrir^ 

Cause the definition of the spec Hied object 10 vanish. r*)le: When you define a function 
using. 7TJ, it checks 1o see if Ihere already exists a procedure of the same name, and if zo f inquires 
whether you wanl the old delinilion ft/T/FSA'd, This is It) credent you from accidentally overwriting 
definition-; of functions 


ERASE PRIMITIVE <primitivr nnntr> 

The LLOGO primitive ftiven as input will be erased. You m-&h 1 uree this, for example. If you 
wanted to use a name used by LOGQ for one oF yOur Owe. functions, ti you define & nan-e using TO 
which conflicts with 9 LOGO primitive, It will inquire il you want the definition of the primitive to be 
erased. 

F f R /1$ Jf IJ NE <nu mh ar> \ E RI. \ 

Erases hre ^number* of Ihg del adit procedure. 

ERASE NAMES [ERN] 

LVibinds all user vanables- 
ER/ISE PROCEDURES >ERP 1 

Erases all inlerpre'ive user functions. Ctoes not eMc-sl compiled or bur ed procedures. 
ERASE COMPILED 

Erases al! compiled user functions 
ERASE ALL 

Like doing PHASE PROCEDURES, ERASE COMPILED end ERASE NAMES. 

ERASE ABBREVIATION <nhhrrvintinn> 

Erases th^ abbreviation given as input. Does not affect the procedure that il abbreviates, 

ERASE PILE *prr> \ERF] 

See Section 10.2. En ! LLQGO., DELETE is a synonym of ERASE PILE, but in I.LOGQ, lhat 
name is used for the LISP function which deletes etemenls from lists. 


ERASE TRACE \EUTft) 

HemQues trace rra-iri ^/unriiiui?. See Section S.6. 

ERASE imv tfuKriiw** ;EflW] 

The ^ unctions wM no longer be buried- f’er * discussion on buried procedures, see Section 

10 . 1 . 
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Sect Inn G- E»flr Handl ing a nd Debugging 


The philosophy fll tl'4 l ISP LOGO er ror handling system it lc Iry to bo as forgiving as 
pcss-btej the system will give ypu an oppOrti.mily to recover Item almost any type ol error (cimjpt a 
bug in ULQG01]. There are two types ol errors which camOtCUr; 


fl,. I Ermr.* 

If fpr some- reason, LLOGO cannot parse the lire you lyoed [tor example, you may have 
typed ntismalched parentheses], this pauses a parsing error. When this happens, LLOGO will prinl a 
mris-sngn tflMing you why it was unhappy, retype ihe ptlending line at you, ant! type the editor 
prcmpl character. You now have a shares !o redeem yourself by correcting the line — yOu may use 
any of Ihe editing conlrol characlors [sec Section 7.tj When you are sabsFied lhal the line is 
correct, type carriage return, and LLOGO will resume evaluat'cm. using the corrected lino ih place of 
Ihe One which was m error 


SJ Run T ime Err ors 

When a run time error occurs, a message wilt be printed, If the error occurs inside a LOGO 
user defined 1 unchon, the message will say spmeth'ng tike: 

jERlltll! IN LIME ^numbrr> OF ^procEdurii?' 
iLINE <nundjer> IS : .... 

;<rcasom Inr rrrnrJ 


11 the errdr Occured inside a LOGO primitive, the message will look like: 

JEQULDN'T EVALUATE ad fnrm> 

BECAUSE 

^reason For errmr^ 

where ^fhad form' is whal LLOGO was frying to evaluate when lha a-rrOr Occurred. Usually, this will! 
give yOu enough information fa figure ogl where the error occurred, although <bail fnrnt> is 
SOnmlimes uninformalive. Usually, LLOGO will simply return (0 1ho (Op tevet loop when such an error 
occurs. However, if you SKT(} 'he variable .'EftR/MErlE tp something other than A'lL, [or MAKK 
*KRRltRE/lK . , , ] a run lime error will cause a LOGO break loop 1o be entered after the message is 
printed. Setting Ihe v^rteb c :f,FSFftR£4R to non-Nff, will cause a LISP style breakpoint to Octur 
when an error happens. [For a delated discussion Of breakpoints, see below, Section S.3.J You 
can resume axmuliOn of your program Irom " he poinl a I which fhe error occurred, by 
CQiYTJM.'fTirvg w j(-p something lc be used in place ol the piece oi data which caused Ihe error, If 
the error was an undefined function, you way QUVTfJVUE with the name of a fund ion which has a 
definition. If the error wjiij, an unbound variah'e, CQNTINl/f. with s value For th^f variable. ]f the 
error was a wrong lype oF mpul 1u a LOGO primitive, CONTINUE with some appropriate value for 
input *.a that furvlion, etc. Usually it will be Obvious from Ihe content what sort ol item is 
required. Com out a I ion wilt be resumed from where the error occurred, with the returned item 
substituted for Ihe One which caused tly* error. I Note: the usual L3SP interrupt handler functions 
eupfrcl a I St of the new item to be returned, white LLOGO’s expect simply the item]. The LISP LOGO 
run-lime error handling works by utiliifing, the LISP error interrupt facd'ty. [' you don’t hhe Ihe way 
LLOGO handles any oF the error conditions, you are free to design your own error interrupt 
handlers, Wither in Llf3P or Irt LOGO- 







3 3 Breakpoint* 

A powerful debugging aid is Ihe ability 1-n cause breakpoints. Stopping a program in the 
process ot being, evaluated allows the user lo examine and rrodify its stele, end explore She history 
or evaluation whkh led up 10 Ihc breakpoint. LISP provides excellent 1 anilities for doing |his r 
ircluding automatic generation of breakpOinte when an error occurs Wherever U$P starts Id 
evaluate a form, it first pushes the form on a stacks IrOm a breakpoint one tan examine the stack Id 
determine whal forms were in the process Of being evaluated, and perform evaluations relative Ed a 
particular it*(k frame. LISP LOGO attempt* to make these Features easily available to the user, from 
either USF 1 or LOGO- Versions ot I hose breakpoint functions ^re jiho available which can run in an 
ordinary LlEP, wilhoul the rest of Ihe LOGO environment. The following Facilities are available lor 
CP lining breakpoints: 

IjOCPDKKFtK srnnJijinn> <rrUirn rrtf«i' J (MOSE; 

Ttie inputs are all optional, and are not evaluated Unless ^cottriirien* nc given and 
evaluates to iVJJ-, fjOCOHRK/iK causes the user to enter a loop where 10GQ commands can be 
typed and Ihe results printed. This is simitar to the top level loop excepl that J t% printed as a 
prompter rather than ?i it is. very much I ke repeal ediy evaluating PHI NT RUN REQUEST, If 
is present, it will be printed oul upon entry to the break po*nl. It also prints the Form in 

n-<? current ■ tat k Frame, wh ch w I b- ..” UKiUtREAK il : ^ '-*m Killy by l"s '-scr |l ihp 

breakpoint happerod because ol an error, the initial stack frame will be the one containing the form 
which caused the error WCOBHK/IK tries wherever possible lo pmnl out Ihs current form as LUGO 
code he!ore il enters a LOGO break pomt. However, the current version is not always smart -enough 
to -distinguish between LISP and LCGQ Ir^mec on the slack, so you might occasionally see whal looks 
like internal LI5P garbage there. [1 you go up tar enough, you are sure to find the LOGO code. A 
smarter version cujld rccog^'^r the LI$P frames and ignorr them. The third input is a detault value 
Ibr L0COIJ.fi /IK to return if it is CONTINUE*. £See description of CONTINUE, below]. Cauliemr the 
breakpoint tunclions described in this section use LISFs CATCH and Tffltfilir. LMabeiled THROITi 
from mside a breakpoint lOCp are h ghiy discouraged. 


n/1 

II control-A is lyfieMt at any time, even while a program is running, il will cause an interrupt 
and a LOGO break penn-t will be entered 

LfSPflftTr/IK CfllcTltrrsadiJid^ ^reJicra uiluf 1 {IfKKAftt 

This is like fXKQHREs IK, except that the loop is a LISP PRINT (EV ill, (REflD))} loop. 
This is especially useful when debugging a set of LISP tunclions designed to run in LOGO. To access 
your LOGO variables and user functions from inside a LISP break loop, prefix them with a sharp sign 
[ H # H ]. LISP users note: you can mleract with Ibis break loop as with the standard LISP If R E A If 
tunc!ion, except Fbal il is set up Id allow use ol the slack hacking functions described 1 below. Ft fP is 
typed, or (CONTINUE) invoked. She cpriurn will be the value OF thrr calMo ItSPHRE/iK. 




As in USP, AM typed at any time will interrupt and tavse a LISP breakpoint to be entered. 
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MKHBftE/lK 


[f this variable rj nqt |VJJ„ when a cun line error happens, fftGORflEAK widl bt tailed 
automatically, This g-ves you a chance Id find out what went wron^, and rpcbver by COiVT/Mi'Kirg 
■with a new piece oF dale to replate the one 1 hat caused (he error, tf is initially set 1o NIL. As in 
1 1LOQQ, the function DKHUG will also change whether breakpoints occur on errors, 

iLtSP BREAK 

like iRRRttFH/lK , except that if set lo something othnr than ,Njtwhen an error happens, 
LSSPIIRKAK rather thao IfiGO PFH HAK will be called, tnilialty setto NfL 

The (oltowiri|j (unctiflrs can be called From inside a breakpoint So erarnins &nd manipulate the stack,: 

VP 


Mbves 1 he breakpoint up one frame in the stack, printing &yt the lorm which was aboul (o 
be ecalualed in that frame. This wil be I hr: form which called the one which was fast typed out by 
any o( the fund ions mentioned in this section. Evaluation row takes place irt tho new sleek frame. 
Thrs means IhaS all local and input variables will have 1 he values t**y d d when Ihat form was about 
to l>e evaluated. However, side eflecFs such as assignment pi global variables are nbt undQra. 
Frames are numbered tOr the user's convenience, From 0 increasing up to top fcevel, 

VP SniijTjfjcr 1- 


Goes '-iturnA^ frames up the stack, like dping UP, times. The ^namier* may be 

negative, in which case, the breekpbml is moved down the stack rather than up, 


VP <nli;ni> 


Goes up the StSdk until a ca’I tb (he function whose name is <nurnt> is found. 

UP <olem> c numftr'r> 


Goes yp the stack until tho rnfrrf^th catl tb is Found. Searches downward lor the 

^ hm irr^qr” t h cal' to Ite specified function if ^umtnr> is negative, 




Like [,■ I th , except lhal it proceeds down the stack instead gF yp Both inputs are Optional, add 
default as Fpr L r P, evcepl lhal 1 r?nnrfnm^ deFaulls Id -I instead of t|, II <nnimfipr> is [iven it 1$ 
equivalent to f.'P T-^nr imhir>). 

PRIWR/P ^ai4JH> ^liiiltifrnr> 

Accepts inputs as does UP, but instead or moving llir breakpoint up the slack 1b the 
desired frame, all frames between the ■torrent pnp and (N» one soecitied are printed out. This 
function i$ awd Fdr gotlin(j a quick view oF the stack in the immedfatq vrtmity bf the breakpoint. 
The b reakpoi nl remains in Fhe same Ir-amr as before I ho tw<n inputs are optional, and default as for 
UP 


PNINTDQtyN rt*:- ^MirmPrrr' 3 ' 


Like PKtNWP, except that the inputs are interpreted as (Or OOFFiY rather lhan at lor UP, 
that is, ■) prints- Frames going, down the sFack. 

EXIT ^rtfrurJt-r,*[Jiifl> 

Causes the turrenl stack irane to return 'with the value ^nTferfl-ewfui 11 *. That is 4 the 
computation continues as if the for pi in the current tra^c Had relurred with *rvta.TTi-vnlttit>, The 
input 1$ optional, and defaults to NIL 

Of) AT f NUU K return- j Lft] 

Causes Ihe trame of the originally invoked breakpoint In re I urn with. the Specified value. 
The input n optional Use CONTINUE to return a new ite m of data IrOrn inside an error breakpoint, 
(or instance a new function name to usn in place oF one which was undefined, Mote th.pl in many 
siluat ens, for examph; From a user-invoked breakpoint or (rpm an error breakpoint wh ch erpecls 
an item to he returned as I he value of the form which caused the error, if you haven’l moved the 
breakpoint around Ihe :.F,nk, CONTI.WE will be denlica! Fa EXIT. !t Fhe input to CONTINUE is 
omitted, the tlelaull return value specified by a thrrd mpud I a AFSFJ.rflfi/lN or UIGOHRE/1K will be 
returned as the value of the breakpoint. Il no such def-airt return value was given, Nil, will he 
returned. $P can also be used to relyrn Frpm (He breakpoint, just as rn a U&P breakpoint. Note 
that this wo-rhr, a b>1 differently IrOm CftiVPTiVr^ in II LOGO as when Ihe breakpoint relurns, 
execution cdntmue freer exactly (he point at which- it ^35 interrupted and not beginning with the 
next line of code-- 


Here’t am example; 


■*M/IKF. ’F,KHltRE/fK T 


^HANGING ft SYSTEM NAME 
T 

mi scpewvp j n 

>1 If :N-G THEN OUTPUT UNBOUND 
>? OUTPUT SCNEWUP -.N-! 

>ENI.i 

; 5CnE'.VUP T1EFINE0 

1SCRKWUP 3 

lEIUlDH IN LINE 1 OF SCREW Iff 
3 LINE 1 IS: IT :N-0 THEN BUTFUT :IJNBBUND 
^UNBOUND IS AM UNBOUND YAJUftEllE 
iBRtlAUlTBNT FRAME P: :UNRE1LINIV 
?:,V 
& 


TJUP 

iOllSAKPDFNT FRAME 3: OUTPUT MNMlTJMD 


/DOWN 

;BREAHPPINT FRAME 0: rUNEUimti 


lAssure LOGO break happens! 
[when an error occurs! 

[Deline ogr losing, procedure/ 

[Count clowh to 0, then! 

leva! variable winch has no value! 


[Frame 0 is the variable, Eva! was! 
[working on I his when we bombed! 
!We tan do any command! 

[while in |he breakpoint/ 

IGoing up a ira-re. UNBOUND', 

[was the input to 6VTPUT 
[going down 0 frame,! 
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7 . up scKEiryp 

:BR fifth POINT SHAKE T; SCREfflVP :N -3 

*:N 

I 

?,t>F ’SCftfilFi/F 2 

^ESRF.AK POINT FRAME 10: SCFIEYV1JP :N-1 

TCr.'V 

3 

7.EXIT SCtiRUFtiO 
SCREWED 


Iwe arrive al recursive invocalion! 

Vhe^e ;S had the valve L! 

131 we rise past Z calif to &CXEWUP* 

!r,V wm M 

I'A'i: (litLidr lor some ruiucDr'! 

!1hal SCBKHTUF of 2 is f 
!lo rplgrn the value '-SCREtF-EJ?! 
land all the previous invocations ’ 
tot SCfiEPFr, l P relurn with I he value’ 
FSCFftlFEf) and wc are at top level! 

Wasn’t ttol 1un?l 


6- 4 VVrunjr Number nf In puls Error* 

S-ince LOGO oyntav requires that the parser know how many inpytt$ a tgr»ctipn requires, and 
LLOGO p-arses your inpul as you type it in, errors may be generated if you change the number si 
Inputs a function take-s- by rDefining 1 he flection, or by falling F,DITTITl,E. Calls lo that tunetipn 
whjoh you typed previously arc Ww incorrectly parsed, LLOGG will titch most octurrcnc?es pF this 
when tbe 1 unction is -called, and print a message I ke: 

iRITFARStHD LINE ^number? DF <p™«tUire> AS: *n.tw sparse> 

and altempt to recover, LLOGQ always attempts Id reparse a line which caused a wrong number of 
inputs error, ]t is r»ot always possible to win, however, as. Side effect? may hiivq occurred before (he 
error was delected. 


a,5 Carta age Coiled nr Efraf* 

Versions 01 LLCQO running in BIKP LtSP [LLSPs with the capability of dynamically 
Altoc-atinfi Morale] have special tinndlers for garbage collector interrupts, ff it decides you have Used 
loo much si or age space of a pa^ticu ar type, or too much slack space, it will stop and politely ask if 
yOu wish more la be mJderl. If you wri: these ci uirsl iQniv repeated many times in a short Span of lime 
while running cn? prugr^m you should give serious consideration Id the possibility that yOur 
program is doing infinite CfJiVS-ng or recursing infinitely. 


R.b Other fir-bug?in et Facilities 

The standard L3$P TR/KJA package may be used to trace LLQQQ primitives or user 
functions, The tracer o rept normally res-dertt, but is loaded in when you firjt reference it. $ee the 
LlS^ manual- For do I ails on the synlan of its use ar>d Ihe various Options available. No LOGO step by 
step evecution interpreter comparable to the 11LQGCl STEP facility esists, but stepping packages 
written for LISP can be used «n conjunction wth LLOGQ 





11.7 Internclinn hviMi LISP 


[o debugging femetion® written in L15P for use in LLQGQ, it is often useful To be able to 
switch bach and forth between LOGO and LtS-P too level hoops, Vou can leave Ihe _OGO top level 
loop and enter a LISP RRAQ-EV Af.-PtlttfV loop by usin^. the LLOGO funtlian Ll$P. From Ihrs mode, 
eisecoting (f,OG(H [remember lo lypg The parentheses, you're in I [SF!} will return to LOGO. Typ>rg 
coni rot-upar raw [«a] at any time will cause an interrupt end switch worlds-; you wilt enter LCSP If 
you typed aa IrOm LOGO, or pnler LQGO if you typed il fro™ I JSP, Il« LISP loop gives you access 
to all internal LLOGO functions and global variables, which are normally inaccessible from LOGO since 
they are on a different abarray. LLOGO primitives and syslem variables are on both ob-atrays, so 
they wilt be accessible From bolh LtJP and LOGO, but LOGO user tuncfiOnt and variables are On ihe 
LOGO obarray only. The character tharp ^ign [>*] is an Obarray-swilching macro; Id access LOGO 
ysfcr functions and variables from Ihe LISP loop, prefni them with a sharp sign, 
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SfrctiOh 9. Gtimtpihnf LLOGQ User Procxdurci 


LISP LOGO comp-les a LOGO source program into LISP and il is slored internally only as 
LISP code Since this rs line c*ne, ihp LOCO user ha? the capability of using the LISP compiler 
directly on his LOGO programs, and obtain a substantial gain In efficiency, ones his programs are 
thoroughly debugged. Lt$P LOGO provides an interface 1* lhe LtSP compiler which should make it 
unnecessary IQt fhe user !o worry about ihterjctFhg with a separate program. 

To compile all *1 the FuncliOns currently in Lhe workspace, the Function COMPILE is 
available. [This does, not include buried procedures — see Section tO.l.j Tt expects one word as 
input, Id name lhe File which will conlain the compiled code A second optional mpul can specify a list 
of declarations to the LISF compiler. Per example, 

COMPILE FOff [DECLARE {FIXNUM tlNTEGERV flRI/PJM.E)] 

Thp n*n ^5 of 1 ho- funcM&ns which arc beteil compiled will hr printed Out, The COMPILE fcJrtOliQrt will 
star! up lhe compilation and then r el urn. 11 wil print ano-lher message when the compilation is 
finishod. A temporary Pulpy! file [named .LOGO. WfTW/T] will be written on the current directory 
and deleted after the compilation is complete. The output tile wiFl have at first name the input Id 
C 0MF7LE, and second File name fr!SL [In lhe MULTSCS implementation, the temporary tile will be 
named In^n hjiejiui and placed in the currant directory. The output fite -will appear in the working 
diroclory, with one name, lhe input to COMPILE.] Smce the LI BP cempilgr musl be caHed up as a 
separate program, be careful about interrupting the €0* tPlf.E fund ion before it is finished [for 
instance, by as you will nol lind yOursetF in LlGGO anymore 

The LOGO COMPILE Fund ion supplies declarations tor LOGO primitives. These should be 
sufficient to compile most LOGO programs and the user reed not supply any himself. Sonre al the 
declarations include LISP macros which replace- cb Is to LOGO pnmilives with calls to their tester 
LISP counterparts for effic-enty, and seme optimisation is done. For safety’s sake, all variables are 
automatically dodered SPECIAL Mowtvtr, the wsphijtltateH user is fret to Include DEOfdftEs to 
L'NSFECl tli< input or local variables which he knows will rot be re I ere need globally, or provide 
declarations which will make of tNr test-arithmetic LISP compiler. 

To- load a compiled File ml* LLOGO, say KEADEtLti ^nnnr FASL. This wilt load all the; 
compiled funet-o-ns which were compiled by COMPILE <bnmr\ and also restore the values oF 
variables lhat were defied at that t me. ’he names et cOrrpi-ed funclions will be kept On a lisl called 
: COMPff r El) nnc: not on -.CONTENTS- For debugging purposes, you might want to read in both lhe 
compiled and interpreted definitions Of the same lunclions, and you can use the functions 
FtlfSltCQMPtLEt} [ELC] and FfXJSItfffTEftPRETRH {FL/j to switch back and 1 forth between 

c Cjit pi Inc! and interpreted definitions. 

A lew warnings about compiling LOGO procedures: First, remember that LOGO syntax 
requires lhal it be known how many inputs a function expects, before a decision can be macte as 1* 
how to parse a line of LOGO code. It. when defining a procedure, you include a calt to a procedure 
which is p* 1 yet de lined, pa-rs-ng is delayed uni il run lime [see SecliOn 6 and Section 3.2 dl thi* 
memo fpr mpro eMails], The- compiler, of <OvteC, {-anriot do anything reasonable with an un-parseef 
line of LOGO code, so a'l parsing must be completed by the t rue the definition ot any procedure is 
compiled, T’hq COMPILE function attempts to make sure (his pe the case, Therefore., if is an furor to 
et tempi to comp le a procedure which contains a cadi Id a procedure which is not a LOGO primitive 
and has not yet been defined. 



Also, if must be renemberpd Ihst compulaliOr» ol LOGO procedutes, like those Qi U5P H is not 
"foolproof". tt is npt always Ihe case lhai a oroeedu'e which rt/ns correctly when interpreted, will be 
guaranteed to run correctly when compiled. $el1-modli'yir^. procedures, weird control structures, and 
in general procedures which depend heavily on maintaining the dynamic environment of the 
interpreter may tail Ed compile correctly without modification. 
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Section lit LHinfi FiIm |.I,Q(TO 


A (He- r.peeifkation on ITS has- four components. Each [he is named by two words, of up to 
siy characters each, a device (almost always. fJSK], and a directory name [usual 1 y the same as the 
user’s name]. You tan refer to a file in LOGO by using any^hrre from 0 to wends. ft you leave out 
Itie name altogether, it will be assumed Shal you are referring to Ihc last hie njmc menllonetf. One 
word will be taken as ’ho frr^t File n»me-, and Hit second will default lo > p which means I he highest 
numbered second file name which curronlly cmsls if yOu are reading, or one higher if you are 
writing, two words will be taken as |hft fwp file names, and the directory and device will be 
defaulted. Jl three names arc given, the third will be assumed as the direclory name, and the device 
will he Q$K. |f four words are given. I be third is device and fourth is the directory, Here ate some 
e^arniplesi 


{Assume that the current user name is f$C, and FQO 3 is the highest numbered File with FOQ as ils 
Nr si filename] 


LOGO 


ITS [sfiit v <lri2-* <aev'»r<chr>E] 


READFILK FQO 
SAVE fog 
KEjWFII.K FQO UAR 
R RADFti'E FQO W.4K IIKIHRV 
READULK FQO RAH DSK HKWiY 


F QQ> DSfiiFSC: /FQO 3/ 
FQO > mK\F£€ t fFOO 1} 
FQO Jt/]ff n$K:FSC; 

TOO RAN DSKAfKNRYi 
FOO HM DSK.HFNRY; 


See Section ] 2.2 and Scclion 1-3 lor mfor mat ion about (fie specifications on the MULTtCS 
and TEPJ5-0 implementations. File specifications ar e accepted by LOGO in the same format as on ITS, 
so d may not be npcc-^sary to change any code to run on other implementations. 


10.1 Saving and Rcidiiie Kites 

There are two ways of storing LOGO programs oo llv? dish for later use. To store the 
contents of the Current workspace [all user functions and. variables currently defined] On (he d i; Sh in 
the form of LOGO sou T ce rode, use If expects as inpul a file cpetifitafion, as discussed above. 

The file created will t ordain. the contents of the user’s workspace, FuncliOn definitions and UAKEs 
for variables, c-xvicliy in Ihr form that he would see if he d d a PRfNTOUT ALl^ 


Workspaces can also be saved in LIS P format, as they are represented internally by LOGO, 
This is accompl shed by the tunclion WRITE which tales ils inputs as does SAFE, Allhough the file 
created will mot be 50 prelty to look at if you print it, using IFRITE produces files which are 
considerably faster to reload, Sunt# the program does not have to be reparsed. For long-term 
storage ol programs, however, it is recommended that you use S4I'E rather than WRITE. Changes 
in the implementation ol Lt$P LOGO may result in changing the internal formal ol LOGO programs, in 
which case, Ides created by tTNfT'R would not remain eompalibie, but files created by S/I&'E' would 
remain so. 

To reload a file from 1 he disk, use the Function READFILE {flf). This, accept a standard 
file speciFicalion, and reads il m, prinfing th? ramp of (he file R KA0F1T.E does not care whether 
the fife is in s/ll'ffd or IFRJTten form. If the file was created by SAVE, lines Of code will ho printed 





oi,rf as They tome in from the disk. For written ('let, orMy the names of functions anti values of 
variables will appear. If you get annoyed at all thr? output, yau can shut i( up with f.JT, LOGO will 
return with t nue-stiOn mark when the loading is fpintilete, 

it is often convenient to treat a set of functions as a ’’pacKage" or 'subsystem - . Fat 
instance, you? may have a set of your favor lie fyivclions which you olarn in your initialisation fil®, or 
a set of functions denied for a specific purpose. W-en this is the case, it is inconvenient Jo have 
dll these functions written out wlm-, you are working on addrhonal procedures, or have to see their 
definitions when you do a PRINTOUT ALL Thdl is, One would like a mdhod of having the package 
Of functions available. bul not considered as part of Ihe workspace by certain commands. You can do 
this by Ljsmrjj [he function FURY. It takes uneval gated protedi.re nairas as input, and will assure that 
Itwi function IS larvo^d by I he fol'Dwins cOmrra^ds: PRffmK/T PROCEDURES PRINTOUT All 
PRINTOUT TITLES, ERASE PROCEDURE ERASE AIL SAVE, WRITE and COMPILE Otherwise 
Ihr function is uoptfccted, and can he invoked, printed, edited, etc. A list ot the names dl buried 
procedures is kept as I ho value ot the variable iBVRIMt RVRY ALL will WRY alt currently 
deFined procedures, and JTfl/JSE flL/WV will undo the cited of a Hf/fll'. 


3 0.2 Other File (Tu inuiaiuls 

F fit STOUT VILE {POT} will prmj out fhe contents of a file. ERASE FILE wilt cause the 
specified fife to vanish [Thii has a safety check to make sure ydu don't do- anything you’ll be sorry 
about] These take Me njupes as above, escept |h*( if only One input is £iv#h Id ERASE it defaults 
to <, the least numbered second file name, ujain for safety reasons. PRINTOUT INDEX [POf} will 
prmt out all the file names in the directory specified oy a-e word t/SE will charge the name oF ihE 
default directory. 
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Sect ion II. D iffcrcncea b-elwccn ILLOfTO fin d 1-LOCO 


LLSP LOGO was Originally wrilten 1* be compalible wilh C1J0Q& a version of LQGQ written in 
POP 10 assembler language, Th*r* noyr txisls 3 version cf LLOGO which we believe lo be 
"semantically compatible" wilh the PDPLJ version. By thij we me^n |h?t ihp vocsbul 3 ry is the seme 
— *Py primitive in 11 LOGO also exists in LLOCU end will (hopefully) have the tm fwahihj, LLOGO 1 
in fact has many primitives which do not cns.t m L ] LOGO, a? well ?s oflermg I he user access to Ihe 
lull tip.-ibilibos of LISP. There are substantia* differences belween LLOGO and 1 ItOGO with regard 
lo File systems and error bend img, and somewhat less substantial differences in the editor, 1ur|le amf 
music pachag.es. Thei.e ere described in detail in c>the r s-cclioins df Ihis document. There are sl-so are 
several less sub-stsinhal dd Fo r cnees, not mentioned in the preceding discussions, and what follows Is 
an attempt to provide a reasonably complete list of Ihe knowledge thal *n experienced 11 LOGO user 
would need to use LLOGO. 

In 1SLOGQ, the double quote character ri is used to specify that ihe atom 1 allowing, r| i; ndt 

10 be evalusted- 

?PJTf,VT ' FOO 
FOG 

11 is like LISP'-? single quote, except thrl it also affecls the LOGO reader’s decision about when lo 
slop including successive characters «n forimn@ the name ol an atom. |n 

SPRINT iFOQ** 

Ihe plus sign is 4 separr^or r-.?r^clcrj il ?ig,n^l^. Ihe end pf the atom iFfX) jusl as if Ihere was a 
space following .Ffifl. However, following a double qiJote, the only separator characters recognized 
are space, carriage Titurn, and square brackols. Thus, in i I LOGO, 

?PRfST ~FOO*-3 
TOO +3 

In LLOGO. the user may use the LISP single quote to spocily 1 hat am atom Or parerthEs-zed 
list following the s»ngle quole is not to be evaluated. The presenter of the jingle quote d(tes nOl 
change the w;iy LLOGO dec do 3 when an atom, ends. te LLOGO, 

?fWOT’Fflflhl 

{THE INPUT 'FRO TH + 3&GF TMK WRflNQ TYPE 

because the o'us sign is still a separator chapter LLOGO uses Ihe dbuble quotes as CLDG -0 doe si 
tiiK-y 511 c always mslched. [f erne s-expression (atom or list) occurs in belween double quotes, i( is 
quoted. IF more than one occur?, the- liil Cpnljinirg them is qu&ted. The correspondence between 
LLOGO ddubte quoled expressions and LISP s-expressions is as follows: 

4,H -=> mi 

*-> (QUOTE 

~*fl> .,. ^x,V>" ==> {QUOTE (**i> .... J 
*<' : t i> . . <iN>T —> {QUOTE .., <.1.V>.).I 

Square brackela in I Ji LOGO specify quoted l»sls. Parentheses are never used around lists 
as in LISP, but ere only used to delimit forms, LLOGO rctOgniccs square brackets as well as LESP's 



parentheses in denying lists. The di Florence be I ween "brackets and parentheses in LLOGO is that the 
bracked always denote list constants, and nol lor ms. and that the Duler level of brackets is implicitly 
quoled; 


[{FQo bar}] -■> (quote <{*00 BARm 

There is s minor pi Mali in the current mp'-enentalian: rote [hat top level pjfenthesei implicitly 
Quote [ho list, interior ones do not. This does not always work, tor instance when using RUN one 
may expert interior Ijifls jilso Ip remain unrvaluetcd: 

'PRINT IPRIST [FOO UA if]] .»> <PRfNT (FRIST (FOO B/lfUf) 

FRtNT fFOQ BAR} 

?RVN [PRIST [FOO —> (RUN '(PRIST fFOfl BAR})} 

prints Ihe value of Ihe tunc I ion FOO applied to input IIAR. 

Square brackets in 11 LOGO also share wild double quotes the property described above of 
affecting the LOGO reader 1- ., decision pn e-nding, the nam^s pi atom:;. Wilhtn a square bracketed list in 
i JLOGO. an alOm is term naletf only by a space, carriage return or bracket. This property is nol true 
of -squire buckets in LUOGO. In L10Q0, [FOfJ+Jjs a hsl containing three elements, but in HLODQ, it 
conlains only one element. 

String quoling m LLQGO is atcOmp ished using She dollar sign character., J. L.LQGO will treat 
anything appearing between dollar signs literally, with special characters devoid ol any special 
•meaning. Wilhm such a siring, two consecutive do lar 5 gns will be interpreted as a single dollar sign. 
So, JSSJ" would be [lie word whoso name is $ single dollar sign. JS is the empty word, ftubout. 
editing and inter* upI characters cannot be quoted in this manner, Use the flSCJ/ funebon of LISP il 
you really need them. 

The character sharp sign ( H ("j in 1ILQGQ is used as a prefix macro character which takes 
one input which must be a word, and euetylej it as a procedure. ]t is used where one wants to use 
a weird name for a procedure, or a name already used by the syslem. Sharp sign is used as an 
escape to Ca I that procedure. Thus, a procedure tie lined in L 1 LOGO by n£) "PJtJVJ' , . . would be 
■callod by m H PRI.ffT, TO . . . woutd be called by # H J h elc. In LLGGO, sharp sign is used as a macro 
character which causes Ihe next s-eiiprets-on to he inlemed as ^f it were read in U$P if you are in 
LOGO, Or as if r! w»s rrad by LOGO il you arc m LtSt 5 . If yPu are in the LLSP mode of 11.000 ?nd 
went So access your LOGO variables, you tan say mtFOO, etc. The conflict may be changed in the 
neat future by altering LISP LOGG's macro character IP One that does nQt conflict with 11 LOGO. 
Suggestions welconw. 

The Boolean [logic at] tonslanls in S LLQG0 are TRVR and FALSE, while in LLOGO, I hey are 
T ?hd ,V/f,, in LtSP. 

The 11L0QQ function IMVEL, which return* the current procedure deplh* is not 

imp K-m^nlpd, 


The character l in 11LOCO is Ireafsd as a macro 'the va*ue of it A is bound td G and EJ is 
bound to C, then -/I -s C. In LLOGO, variables set by HAKE arc jusl LISP atoms beginning with the 
char^ottr l, so ”,A ‘will bo the value of the variable sot by HAKE "r AT <mhntrv<?r>, etc. We are 
seriously considering changing this, eliminating tt>c incompatibility. Thn present setup i-equrres 
MAKE 1o do an expensive F.XFI.ODK on the variable name, in order In create the word which 
begins with a colon. 

LLOGO enpects ta find only one form inside pareniheses: constructs like 
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fFD m ¥ D .III SUM 4 $f 

are prohibited. 1 1LQQQ ailows more than ore term inside parentheses under certain restrictions, 

The 11LOOO pfocedkjre TEXT, wh;h returns a li-?| qt lists which are thfr linr-s pi r 
procedure whose name is given as input, is not implemented in LLOGQ. However, you can access- the 
definition oi a function in its parsed LISP form on the property list [CJ>fi] ol the alon*. 

LLOGQ understands two comment conventions: LISP'S tonvenlien of treating PS P eonument 
anything b el ween a semicolon and the ne*l carriage return, and LOOTs of treating, as a coni merit 
any thing iri between erdamnliOn pOinlu ["he exclamation points n-.usl be matched, and comments 
can toe continued past the- end at the I nr], Anything after reclamation points On a ;jnc is ignored. 

11 LOGO forms are divided rnlo two categories: those that output [return a value] and those 
which do not. |n LILOGQ, as in LISP, every iorm returns a value To simulate 11LQGO and CLOGO in 
this respect, as a special hjrk, forms which return a quest-on mark do not have their values pcinled 
by LLOQO’b top level function. However, LLOGQ cannal catch the error of such a iorm hiding inside 
parcnlhoses, as can 11 LOGO- Mbs I 01 the primitives which do nol feturn a vatue in 11 LOGO return ? 
in LLOGO. 

The lop level loop in LISP LOGO is a HE/ID EVAL FRtNT loop whereas POP 11 LOGO is a 
READ-RV AL loop. This means that 3 LLOGO prints out only when you ask it tq print unlike LLOGO 
which prints Pul values after every evaluation Cl a LOGO lOrm. 

In \ tlQGQ: 

?sE7m i fi 

YOU OONT SAY WHAT TO DO WITH K 

In LLOGO. 

?Sl/M i .'I 

12 

Line num-hers can be any inleger up to Ihe murmurr magnitudr! slkiwerl by Qfi bits, Floating 
point, regalive numbers and zero are allowed also. These are occasionally useful when you have 1o 
insert lines be Fore a line numbered t or between two consecutively numbered tines. 

LLOGO Follows the LISP convenbons tor numerical input. !n LILOGO, a decimal point is an 
indicator of tloaling point input, oven it r® traclional digits follow [like FORTRAN} The LISP 
convention r$ that .-in integer Ini low ml by a detima' point wilhput any trarliOn.nl digits is considered 
as an integer base ten regardless oMhe set ling of the variable IliASR t which allows the numerical 
input rad in to be changed. The number it considered floating point only il some digits follow l he 
de-cim,-il ppmt. In 11 LOGO, I, is a floating point number, but in LLCXXJ, il <& am integer, and 1,0 is 
ftdaling poinl one. Also, iY is no I used in LLGGO lor negative exponent float-ng point input, as in 
t 3 LOGO. E with a negative c*pQnenJ lolloping ■$ the preferred term. 

In 11 LOGO: 

3A41S IV 4 

to LLOOOi 

XUISR-4 

Percent sign 00 does nOl echo as a space. Carriage returns within square-bracketed lists 
print out as such, no! as spaces, as in 11 LOGO- 






:f?.lfPrV is the empty lisl, whith if, LISP 1 ? NIL. ;EMP7T(F is Ihs empty word, which is the 
LISP atom whose print name is (ASCII Oi. 

LISP LOGO and EiLOQQ dilfer on the synlax lor arrays. LISP LOGO uses I he L3SP array 
facility; to define an array utt: 

ARRAY T i dj"rtirrirfiJIi 1> . . , *'dimension iV> 

Values can be stored by 

STORK <orrny immfJ ^Jll&Hripf f> . rjufrlCTjrt JV> <m/m» 

Valws arp accessed as il the array were a tunclion, which expected the saw number of inputs as 
I he number of dimensions in Ihe array. Arrays are not considered si part at your workspace in 
LLOGO, so you can't do PRINTOUT ARRAYS, ERASE /tJtfiyiVS, elc. 

The LLOGO function Ot no inputs, returns a random floating po nl number, which 

is between zero and one. If given two arguments, rt returns a random mimher between its first and 
second argument, inclusive. |f both Ms inputs arr fixed pcnnf, if returns a Intod point number, 
Olhprwise >1 returns a floating point number. (RANDOM 0 behaves at L1L0G0 RAf/BOM. 

ROVSVDOTf in LLQGQ lakes either one or two input?, [f given one input, Ihe number is 
rounded 10 an ir-Mege*, otherwise it <s pounded IP as many places 1o the right pt the decimal point as 
specified by Shrj second 'nput. 


The TIME function returns real bme in seconds, nOl sutwths of a sccOrsd, as in IILOGO. 

IJOCAf r variables are handled differently m LLOGO than in l iLOGO- Regardless ot where a 
MK’./lt, slalement is placed in a procedure, the variables declared wilt be local to the entire 
procedure. This car responds to a PROU variable in LISP. UlCAL accepl? any number of variable 
names as input. 

[nsecting lines inlo procedures under program control should be done using the function 
INSKRTUNK, In L1L0G0, the loll&wing will insert a Lnc into ffLETCtl when MUNC 15 . executed: 

rm .no,vo 

a-JO EDIT ni.KTCU 

>29 ilC PRINT [NEtV LINK ADDED TV JJLflfCff] 

>END 

This will not work in LLCGO. tnslead reel ace tine 20 with: 

>20 INSERTUNE M PRINT [NEW IJNE ADDED TO HI.ETCH] 

None of the L1LQQQ special command? whose name? begin with a period are ‘mplemented in 
LLOGO, all hough thnrn xre occasionally LISP lunction? with diflerent names and semantics which can 
be made Id do the samp thing, 

Their-o rs e memo by Wade Wiliams which explain? some of the finer point? of 1JL0Q0 
syntax, and should he consumed for further information. The 13LOGO User’s Manual should also be of 
assistance. 
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Sttiim lg. Using LLOSO on. MULTICS 


LISP LOGO hat •io\/ been implemented on MULT1CS, aod Ihis is the only version of LOGO 
■available For that system. Etoldw arc mslructions tor using il, and a ir,l cl differences between Ihe 
MULTtCS and ITS version. Except far the differences in file namirvg, conventions, and limitations 
imposed by the operating syslem, source language prcgrams should be entirely coTpalibte For more 
information on WOLTrGS L($P, tee the kfACLlBF Reference Vlanual by Cave Moan. 

The LISP LOCK) music package is available SOr use On kAJLTECS- See Socbon 3 6 for mare 
delails., The display turtle and GEflt^LAtJD packages are not available in Ihe MULTtCS implementation- 
MULT1CS does nol have adequale laeililies lor using, displays such as Ihr 3dQ and Ihe GT40. II 
•probably would be possible to implement a rudimentary turtle package for Ihe storage type displays 
on MULTTCS such as the ARG? and TEXTRQN1X terminals, bul we have no plans to dd so at ptesent. 


r2J Whe^To Find 11 

To obtain, LISP LOGO, you must first creale a link ta Ihe necessary Tiles, After you lo^ in, 

lype 


linjt >y.rTrf>-nfi>f^>fn ga 

This needs to be done only once for each user. Subsequently, you ran gel LLOGQ simply by Typing 
Id^rt 

You should then got a message Indicating the version numbers of lESP and LQQQ, as on ITS, and the 
allocator will ask you if you want to use the music box. ■< you have a lile in your directory named 
ttnrt upJeye il will be read in as an initialization file. 


12-2 File Naming Conventions 

Ap [T& file specification consists of two File names of up ta six characters each, a davit* 
and directory name. A file specification On MULT3CS is called a "pathnunt*", and consists oF arbilrarily 
many composenls each naming a node in a free structure at directories and segments [*'1**1 The 
components ot a MULftCS pathname are separated by ~- y ~ characters. Any palhname beginning with 
is considered to be a full pathname, Le. sla'I at Ihe real oi the tree, otherwise, it is tonsiderect 
to be relative la the directory which is currently tha dctault TNs yritl usually he something (ike 
"^udd^yaur»pra|ec 1 "■name i ydur-user-name", Fiie names are assumed also to have two components 
as An ITS and you type them into to LOGO the sarre way, as I wo words, except that each word it not 
limited to six characters. The deleull second hie name is "Iflgo", not " v ", to be consistent with 
MULTtCS conventions Jn your directory, the 1 wo fde oasies w II appear separated by a "", Files 
whose second names are "last" are assumed to contain, object code produced by the l.[$P compiler. 
This will correspond to the Me with only the first name {na second component} in yOur directory. 
Here are some examples: [assutre your name is "person" and ydur project is "prOfcrt'"} 


LOGO Idp nftme 


MULTJCS hie name 


rvttdfiit fco 
rvadjllrr /ee for 


>u.Ad>f\rt} Jrr l>prr wrrt^jTi5ii.f o jjp 
■>ud j ecPpexMii^/bit.lisr 







r^adjilr ftM} fnxl 
rmtdfile fan frflj- etd JTlfcfc 
rmutjite foft J*ar >K«f d’-lloqa 


>u J fiat 

>u.drf>jtlP(h j>f E>pe tt«rfl Btu Nti ie^feo.har 

*v-dt*lii>ga-'f*a,h nr 


12,3 Ter m i iiiUo^y 

On WLIL.TICS, control cha racier*. are erdered to L]SP by firsl hiding the fjrent or nitre ftey [if 
you h»vp onel and LESP should type CTRL/, then typing, the ord nary non-control character, |hpn * 
carriage return. WULT[Ct5 has ro other way ot acknowledging your eiiislente before you hit a return* 
which is the reason lor this kludge. Because of Ihis the cartlrol-fharacler Eire Orientedi editor whkh 
esfrils in the its -mplementat on, does not e*i=| in the MULTJCS implenenlahorv. MIATICS use* # to 
rub out the previous character, and @ to rub out the entire line, To enler these characters, to LLOGO, 
precede then with 

If you should have to use ?n 30M 27^1 terminal, remember that certain characters must be 
escaped, The wyr*l offenders are J end J (type ’£r*rei-M>Jt> for ( end <neni-xirfn? 

'jCfrarer-JArtiO For ]) ( type ^nur-jiga* to' n, ■cr*nr-.ii ffl n> -jjjfor \ n an d lype a 'eenf-.HflJi* 
before r and is. Upper and lower cases ere distiryguished on MULTICS, and all of the system 
functions, bold MULTICS's and LLOGO's, have lower case names. 

To us-o LESF LOGO o»i WULTECS- aver the ARPANET from ]TS, it is recom mended 1ha>t Dave 
Mcon’s program TN6 be used rather than TELNET, See DSK:.LNPQ.|TN& INFO fa<r more delai’s, 
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Srrl ran 11. U ii-g LLOGO on TEW Ml- and TEN EX syslrms 


The version oT LLOGO Fur TEN5Q runs in a version of MACLISP 'hat is nearly compatible 
with that used *f MIT-A1 Thfi 7EN5Q version car, also be used on TENEK syslpms. Mcsl ®f th& 
ineompatibitif as are those necessitated by the difference ir Operating systems. Specifio^Hyi- tlha- 
following commands arc not i-T.pkmenled: 

PHINTGLT INDEX (alias POI, LIST Fft£S) 

logout m m 

aw PILE 

UNEPRINT 

m.!C 

A1so f fhe special packages For LLOGU fth* turtle primitives, the music primitives, and GEPMLAPiO) are 
ur.»v aiUblo 

Another diUerence between TEN50 LLOGO and LLOGO on [T5 is in the lyp<ng oF control 
tharactors {such as aG 1 a If, and dll Fhe editing characters - Afl a£ etcj, On ITS lhcse charactere 
may be typed al any (imci fhsjsr- n peri lying an interrupt action {aG, a ft) will always lake effect 
immediately. LhForl unate ly, this is not true in the IEH50 implementation, because TEWiO allows a 
running program to lie Interrupted only by Ihe character aC As e result Ot this, it (he uspr wants 
to interrupl Ihe LLOGO system while it is running (t. g. executing a user defined function}, he must 
first type ajC. This will interrupt the program, and cause i! lo print ?A, indicating 1 hal it is waiting to 
read a control-charaefer. The user may then type the desired control character, sod it will he acted 
upon, htole that typing a£ is npl necessary il the LLOGO system is not running, bul rather wailing 
for input Therefore the editing characters may be used wilhnul dilFicully, even On Ihe TEfd50 
system. 


Another ryiinpr difference between the two operating systems is in the notation lor file 
names. This difference is minimised by Ihe syntax used by the LLOGO file commands. For instance, 
the command 


7 RKADEILE PRQCIUI LCO 05 K USER 

will read the file BSRdJSER; FtiOGR If LCO On ITS, while on TEN50 the file read will be 

Thus most user programs will be able to run with little Or no 
modification to Iheir input/outpul operations. (Note tbal Ihe defaull second tile name is > on ITS, 
while on TEN50 *t is LCO.} tf you want to use a LLOGO initialization file with the TEblSP 
implementation, fhe name of the Me shoufd be IJVfF.fjGID On yPur user directory. 

A version ot TENSQ LLOGO is currently available at Cavnegie-Melipu {CMU-10BL It rr»sy be 
loaded them by means of the following command: 


.KL jV mlG99] 



Section 14. CERMLAND 


’hs GERMLAND package ■£ designed I* provide Ihe user with a display environment in 
which interesting nontrivial questions can easily be investigated, without ihe need tar sophisticated 
display equipment. The current implementation runs on any of the character display console in use 
at the A..], laboratory. 


Conceptual!;^ GFRIvSl AND consists Of a square grid, on which may live* as many 1 as ]0 
-germs'. Each germ may have an arbitrary LOGO program associated with rl; this program 
determines Ihe germ's movements, as well as whether it ealo gry qF (h* h i l oed" present at its 
position of the grid- for a discussion of some ol Ihe problems th H t can. be tavostigatad ip (his 
environment, see LOGO working paper 7, 


14.1 Sij rting Up 

Thp GERKf.AMO package may bo loaded automatically at the start of aft LLOGO run. When 
si acted, LLOGO will a$k which of (he special packages you want. Simply lype YES, tallowed by a 
carriage return, when it asks whether you wnnl GLHMLAND. The GERtAANO package will Ihen be 
loaded, and g>ve you instructions (Or lurlher help. Mote that if the grid becomes garbled, because of 
a transmission err nr 1o* instance, yOu Can al a^y lime cause it to he redisplayed by typing the 
character a\ [conlrpl-backslash]. 


14. 2 To pleve) Primitives 

HUNGER tJ 


Invokes prpmplf Asks questions necessary Ip get starled and p ( Fefs help. 

GERMDEMOS 

Runs a series of demos,, leaving Ihe demo programs availably for the user Ip play with. 

TOPGRRM 

Starts up a GERIvTlAND READ- EV AL- PRIST loop, using the grid sbI up by the most recent 
call to RJ jVC 

VSCRID 


Exits Iron TOPGEKV, bark ta LLOGO, 


RE PRAT < /.’T&Kfti I * ^jurrijj-rtf 


Each program defines one creature. A round consists Ol executing each program in turn 
Alley path rpundl, Iht program wails lOr inpul. ]t the user types, 0 space, One round is performedi if 
the user types a number; that m*ny rOotids are done. This rs repeated indefinitely until an error 
octuirs. REPEAT is rOl sublle wilh respect ta parallel processing. No el Fort is made to try each 
prngra-m and see whether any conflict's occur, Huwpver, eventually a> more eleborale verstao could 
be designed that was sensitive- ta nyr^hromzing ihe hves of Ihe germs. Lf no programs arc passed 
to- REPEAT, it attempts to u£r Ihn programs associated wilh each germ fey Rt/ficERM 


□ERMIANTI 
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14.9 Ctn.1 Primitives 
Cff ID 

[ndialrzes GERMLAHD. A square grid is croa(i?d with <wh^n> squares in a- side 

PRfPTCiUP 

Clear screen and redisplay QEUMLANtJ grid. Typing a\ alsd causes th>S to happen. ]f there 
is a germ <)n lhe square, the character which represents thal germ li printed in the square's 
position, [f the square is an obs1actc h ah i^5 printed, ]f there is food on the square, (hr Clumber 
Of particles is printed. |( the square is empty, a H . h is prilled. 


CRfRP ’ ir paxiti(}it> 

A predicate which outputs f iFI (he position ■$ a legitimate grid square. 


(Ffi/IF 


Go into 'wraparound" mode, in which norms are allowed- lo go across the boundaries of the 

grirt- 

NmVR/W 

Lea^'O "wraparound" mode. 

Note that WRAP and NQWRfiP affect the variable WRAPAROUND- See Page 46. 


AfOl'fe’ ^pu.iirjitn> 


The germ is moved to Ihe Specified grid square, ^pnrhion^ is a sentence &f (he * arrd y 
coordinate^ of the square, fypica' use is: MOVE NORTH- IMhe g^rtri moves to a square which is 
already inhabited, the former inhabitant is hilled. MOVE prints -an error message if an attempt is 
made to iWtJt'fi to a square wdh an obstacle on It, cm a square aiitside the grid. The r -po*itiifn> does 
r*o( havo to W adjacent to the current location Of Ihq eorm. Weoce, MOVE allows ran-lucel 
movenr.enl to any grid square 

STEP ndire^fnmv 


't-direelron 5 ' is inter preled as a heading. It musl bo cm the r 0, 30, 3 -SO Qf 270 fmod 360b 
STEP allows more elegance in I he description of a g*rm srggrfAi. If the sane structure is used for 
all directions, then the program can call » subproeeduce whose input is cycled through the lour 
directions 


14.4 Property I*rrin»tive* 

PL/TSQUflRE s^nflfnn> <pn/flrjnnlffliji> <pr6p#riy> 

Fo-r the specified grid square, the data stored under the given property is set to 
lien*. 




fid It 1 * ^pmprrly* 

The ml o r n a | i?n £ fa reef under ihe < .pr‘#pwjy> is ire-turned, Typical uses are-r 
fCKTSQUARK ' : jiaiilititt'* 'f’OfJ'D.J rrIijrn?. 1 -!jDd al epoiili^ig^, 

(Ch 1/\Hh, ^.pij.rij'iiirfi* 1 INIIARITANI i relurns the number oi ihe germ currently living, 
there, Nft, |f unoccupied. 

fGFTSQUfUtt: • : pt>minn'* 'QRSTAU.F!) returm T iff the square is an obstacle. 
ftEMSQU/lftfi < prii'pi'rty> 


Removes information stored under < jjr' 4 >pr* 7 -a 
SF fl AT < pfuii ra-on> 


Oulputs ah ol ttie n I ijf tis I ion stored for 1 he given- ppjil ion. 

FOOD t prs.<a’ri"r?iii> 

Outputs the number of food particle? *-1 the given ppsihon. FOOT) relur-ns not Nil,, whan 
(here is nn food. 

FOODP ^potidt>tt> 

Predicate which telurm? number of food parlides iT any *1 Ihe given position;. Nil, if none. 

FIUFOOD <n> 

Puts ^j? :r morsels of load an each sqru*rc of QEMAli). 

RAT ^numhfry 

Subtracts <raiin^r? of iood oar'ides from the current square. Generates an erf or if 
<nmmJi-rr> Is larger than 1 he total faod available- There ere Iwo lypes pi germ? ~ Ihfrse thal ere 
hungry ard Ihose that arr not, Each hungry germ has a food supply associated with it. The food 
supply rs mtr:‘ a'.rrl every lime he eats by that hum her pi parlides, and decreased by o« for each 
generation. Ef il ever reaches zero, the germ dies. So, if he eats only one particle ol food on a lorn, 
he must eef eg am On Ihe nexl turn; rF he if its 2, he can s^ip a turn wilhoul eating, etc. 


11,5 Multiple Germ Primitives 

WIIERB <ia*rm* 

Returns Ihe copr di-nates of the square I hat igerm is currently inhabiting, 

NORTHl r 

Returns true only if the x coordinate of rgerm is greater than |he X coordinate of the germ 
whose program is currently being executed hy REPEAT. 


GEhMLANP 
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south p 


WP.STP 


T/1STP 

Analogous. lo NORTfIP. 

KfU. 

Assassinales ^rprrjw^ anti prints- eulogy. 

CKWiW 

Initializes igerm lo slarl put located al ^nfuan?*. :germ is an integer between 1 and 10. 
FOQDSUPPLY <-f(-rnt> 

Returns the emoun1 oF Food thal Ihe ^erm has, 

Tfw if and only if <r^rrm> tan gel lo <4tpHnrn> nn his neat move. 

H 1> Turtle frithiitivca 
tfKADfSC 

Pel urns Ihe current heading Of Fhe germ. 

FOHH 7 IPO <jiurofcnr> 

Move cjtuHtfcrr* spaces in the direction Ol Ihe currenl head ng Abbreviates to FD 
s,niinnftr’r>. rjnutJuv? may he insgalive. 

RfiLK *tiu.mh+r> 

Move ,c H E j.nihr»j‘> spaces OppOsilc to the Current heading. Abbreviates to RK sjinniAer>. 

ST XT ^diiwiion* 

Returns the coordinates ot Ihe nesrt square in Ihe current direclion. 

RfGifT < it a Ittfrer s 

Turn rrght <nujnAni > > degree;— snuimh&r* should be a multiple of 90. This may he 
abbreviated as AT Sftumfnrr* . 



hf't-r 


Equivalent 1o fll^CfFT Abbreviates n LT ^nun^, 

FRONT EFSJJUft’j 

Returns coordinates oF the square- in ir-onl ol the turtle. 

MGtlTSWE iRSIDE] 

REAR {BSfDK } 

UifTSWK llStHKl 

Analogous to ffiflJVF. 

H.7 Tout'll Primitives 
rO(/(!W ^fWRlinn^ 

Outputs \JE if dQps not cOnlam something Hut t*n be touch'd. Otherwise it 

Qutpuls an atom describing the touchable objerl, e.g. BOWflli'fi or (iRSTACIT., Typical us* Id 
TOUCH FRONT, 

OHSTROCT ■‘‘■XitjtHtrf* 

Puts an obstacle at CFfuare*. 'Germs cannot move onto ttfuaros with obstacles. 

DESTRUCT 

Removes obstacle al ^guara*. 

t4.a Glo b al Var iables 

&FRM 

The number ol the serm whose program is. being executed by REPEAT. 

sGftwsiZK 

Sire of the GEKMLAMD grid set by the GftJjfJ 1 unction. 
tlfVNGRY 

T ^ Germs are killed if their foodsupoly gees to 0. 

NtL =~- r A germ’s loodsupply is ignored by REPE/IT. 
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iJFJMJMfiflt/.Vft 


T " J MfltiOn across bprdcr-5 is pfcrmitlfcd. 

JVff, => WetiOrt JCI-&5& borders >i irt frtmr. 

The user should nevpr change WRAPAROUND dirtetty. Lfcfl WRAP and NQ\F ft/if* to 
thing,* mode-S- 


14.$ Implementation 

GEfi'KtflWD uses an array lo represent fhp grid, and addMiOrva! arrays 3flr e-asy attess td 
info-Thtalion about a parlicular germ. The individual primitives a-re, for the must part, 
straightforwardly inplenentable, given th«s dal a represenlatibn. Some care is tahen in interfacing 
with ihe -standard LLOGO environment, so that alt the usual debugging leatutfes of LLOGO fray be 
kjaeril in the- development of fierm programs, without interference wilh the display o( Ihe grid. 



Section E5, DisplJJ Turtle for the 34fl and GT40 


The ciisplay turtle package For the 3-40 and GT40 displays is also usable From an ordinary 
LISP as well as from LLOGO, Oo < FAS LOAD Tb'RTfJ, MSf, PSK LWGOl 


15 3 Sorting The DHpfcff^ 

STARTIHSPLAY fSD) 

Ini-tijiiii'cs the screen, The turtle is displayed at It* home, the center at the screen. This 
coinTiandi is also usetu' tor restarting everyltii* 1 ®, ^hem things get Fouled up, the PDP& loses, etc. 
STARTMSPI.AV ’GTW ystrs thr GT40 display rmiher than the 340 display. If you are using the 
G140 as a display for the LOGO turlle, it imtsl nol be logged in (o ITS as a console, 

jvftn/sp/TV E'Vft} 

Says you kvant to slop using the display. Flushes (he d sol ay slave. 

If the display slave lor Ihe PDP-6 dies, check 1 hat the run light is do, |1 net, stop, io reset, deposit 0 
in 40 and 41 and then start. 

LlSF has three control charatters for the display: 

a,V 


Tu»ns □ Ff display. 




□■splay prints tike tty. 


f\F 


Turns on display For turtle, assuming a prior call to SrflKT’BJSFL^ry. 


15 2 Th e Turt le 
tflDETURTLE |/JT’J 

Wakes the turtle disappear 

SSIOWTURTI.R (STt 

Brings the turtle back to life. 


Display Turtle tor the I4ET and QT4B 
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tvrtlestate 

Returns 0 if the lurlle is not displayed, else returns the va'ue of TURTLE, ^TURTLE is I he 
number of She display item *’hith the current turlle. 

MAKTURTt E 

Tbe current turtle is replaced by the picture drawn by Previns capability to 

rotate pictures. Subsequent turtle commands, like FfPffPT.'lflO. RIGHT, etc, will make the picture 
drawn by Wr> move as it il were the original turtle (triangle} 

OLDnJRTLE 

Res I Ores the original LbQGO turlle 


ljr -3 Moving Hie Turtle 

FOftiT/lFD [ffl] 

Moves the turlle <iirpr> ; n [hr jj rBC trOn it is currently pointed 
R/KK \ If h ] 

Moves the turlle c±if*pj> opposite- to the direction in which il is pointed, 
SETX <*> 

Moves the turlle Id {<*>, yCflU}. 

SETT 

Mflves tho turtle to {StOTt, <y>)_ 

5 XT XV <I> 

Moves Ihe tyr|le So {**■>, ■cy>)-, 

DEI.X <fa> 

Moves lurtte lo {XCOR^A x>, YGOKy 
DELY =dy> 

Moves lUrtlr to tXCOK, YCOR*<Jy>l 

BfiOV - 4x^ J r > 

Moves turtle to (SCO*+<!*>, yC0II*<rfj>lL 



HOME Jlf) 


Ktovei turtle hem* So its slarling state, 


15.4 Erashtjj ihf Stir-rcn 

WIPE 

fr^as the picture On the screen. Does not affect It* turtle, O' any snaps. 
WIPKCI'EAN [IFC] 

Like [I Jl'>], ertepl Hides snaps also. 

CLtiAKSatKEN JL"5) 

Ec,uivalent so IF!PE HOME. 


15.5 Tnrtltllg the Turtle 

HlQlIT <angl*> {HI’S 

Turns the turtle clockwise degrees. 

LEFT [LT\ 

Turns I ho turtle cpunler clockwise degrees. 

SETHEAD <nhfEe> 

The turtle is turned to a heading of sarr^f**. 


IS.6 Exami ning stir Turtle 's State 

1401*: The turtle's homo is tO, 0> and! a heading of 0 cot responds to pOinling straia ht ^P- The 
variables rVCftP. :TtfJH and ittRAMffi describe the slate of the turtle in floating pOmt, These 
varieties should not be changed explicitly by the user. The following functions return components 
of the turtle’s stale rounded to the nearest integer 

XCfJK 

Qulputs the X coordinate oF the turtle 

ycow 


flu! puls the Y coordinate ot the turtle, 


Display Turtle fnr I her 340 and UT40 
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Jlf/lPJJVC 

Outputs Ihe hcsdir^ d( (he lurlie. 


XHOME 


Outputs thu J( coordinate of the turtle's home in absolute scope coordinates {i.e. relative Id 
lower left-hand cornel of Ihe screen) 

YtlOHK 


Out puls the V coordinate ol Ihe turtle's home in absolute scope tOOl-din ate?. 


15.7 The Pen 
FKNDQtTH \Pfi} 

Pen lowered to papr*. Turdo leaves a- track when moved. 

PtCMJP jFt/i 

Pen raised Irbm paper. Turtle does not leave a track when moved. 

PENSTATE 

Returns +1 ■ pgnuo or -1 “ pendown 

PENSTATP ci rp -I* 

Sots the penstale. A common use far this primitive is to make a -sub-procedure transparent 
to pen state. 

PEN? 

T If non is down, else NIL 

HERE 

Outputs (SENTENCE SCflJt VCGW HEAD!NCI Useiul for remembering location via MAKE 
”JP" HERE. 

SETTUttTLE *nlflie> {Sft’TT) 

tiels Ihdr Slate df the lurlle Id jt i sentence Of X cOdrchnate, V cbOr-dmalo, 

and he-adi ng. Thp hpadirip may be omilted, <n which case it Is not *Ffchded. 

R/lNCR <p> 


Distance from the Eurlle’s current Ideal ion to *p*. c p s it a point speufied by a sentence ol 
X and Y coordinates. 



SHARING ' : p' r 

Oulputs absolute dirocl»(3r, 01 irdm 1ur|ln. 

TOWARDS ■- 

Outputs relative direction ^p 1 from lurtte. 

IS & Global Navigation 

Nate: Thews primitives retort fFoaling point il either ot their inputs are floating point. 

RANCH m '-y- m 

Outputs distance of turtle Irom the point 
HEARING <*> < r > 

Outputs absolute direction of (<r>, c y>) from turtle. (SETH E AD (REARING <*> 
pCmls the turtlo in [tip (JirrhtliOrt 

towards <ic> <j-> 

Outputs relative direction of IrOm turtle, (RICHT (TOWARDS *ir> *-y>}) points 

the turtle m the direction &f fsjr>, 

ISA Trigonometry 

CftSI NE *-angler* 

Cosine of ^nittffr!'* degrees 

SINE 

Sine ot degrees 

JITANGENT <*> -y- 

Angle whoso Urgent is «*>/<y>. 

[iij.'tf, COS, ind AT A .V are the tor responding Functions which inpul or output in r*d«ans] 

15.10 Tem 
SJIfJiTr^JfT 

Subsequent printing ii mowed on- the itreerv Initially, printing begins io Ihe upper left 

corner. 


Display Turllr far the 34? anil GT40 
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III DETEXT 

Subsequent printing is no Igngor displayed text currently on the screen remains. 
HF.MTEXT 

Any tort On thp screen is erased and subsequent printing, it not displayed. 


; SHOW 

A variable which is T it printing i* being displayed ML if not. Set by StlOWTHXT„ 
II!DHTEXTi and REMTEXT. Don't tel ft yourself. 

:TfiXT 


Variable containing the number OF the chsplay item which it the text displayed by 
SfffHfTEXT, etc. 

MARK <*> 


fTTPff <x>> it placed at Fh* turtle- 1 * tirtr-enl lor. nlinn SWAP MARK or^atfri » 

snap ai the wprd "1*stl", This allows Ihe word lo be manipulated, i.e. Moved to any part oF the 
screen h etc. 

tTEXTXfIOMK 


;TEXTY HOME 

Variables containing coordinates of texl to be displayed am the screen. Changeable by user. 
Initially ;TKXTXIIOME m 0,„ r l ^^, , ]^^T^FG)MF , , , * 1000, Thp-se bto jn absolute scope coordinates. 


1511 Mailrpilkliile Scenes 

Wert*: .PICTURE is thp name Ihe lurlle’a track. Does not include any snaps displayed via SIIOVP t 
SIimrSNAP, ek. -WRTf.F. is, the name cl Ihe ||*tl*. -.TEXT It th# Harm; ot any test di$plny«d v.a 
SHOW TEXT 

StltlW 

‘ c irrM(;> it moved 1o the current positron of the turtle and displayed- [I is not copied- 

II WE 

^ic-ene* it h'dden bul not destroyed. 

PHOTO <Whit> {5JW1FJ 

The current pic lure it cop-ed and named <jiri-np>. Any old snap of this name is destroyed. 



PHOTO fKfllri [SJV/IPJ 

lhe picture 1 drawn by ffEni-? is named tjcimr*. 

ENTERS N/1P <j,rrw> 

:PICWRK is rebound to a fresh display item. The initial state of Ihis Item hides the turJI*. 
Subseoiuent commands refer to this new ilem. 

ENDSNAP 

"he original .PtCWRE is reslored, 

RESNAP -:*rN*he* 


is made the currenl picture. The OrJy deference between J ?NTEHSNAP 

is lhat a new display ilera is not ere ala d. and th 0 turlfe is not hidden, ENDSNAP iho 
restores Ibe original :PfCTl-‘RE. 

RfrSN/lF <*r.rrw? 


lhe piclure d-rawn by t littr> it added 1o j; aceiqe>. The sfimp is executed, referring. to the 
turtle resnJinu m ---tr+n*> Subsequent commands will refer to the o(d turtle. 

PICTURE < dixjday j’npirfifrJtJji^ 

iPICnjRF, is bound to a rew display item while the commands are executed. The original 
zFtCTlfRK is restored following execution of the commands. Simitar to SNAP <aeene> <wmmn n*f*> 
except lhat no name is giuen in the new item. Instead, the nymbor of the item is retimed. Thus, 
lhe same effect is advened by: 

SNAP SxcriFlO *<•*) Dl JH4 rid r> or 
MAkH PfCTl. : R P ^f-ontmtiAdu^ 

Except that - JcenO is not added tft lhe list ol snaps. 

SHOIFSNAP s» 


A. copy of is displayed a! the lurlle’s current pesilion. 

it I DESNAP c 'srrrr> 


All copies of (wrm 1 are hidden. 


ERASE "'■.iff'trP-' 


AH copies of ^xrrpic^ grp destroyed. 


SNAPS 


A list containing, ? I current snaps, 
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15.12 Holler 
PtJOTTfiP 

The picture currently an the display screen is plolted on a new plotter PIXfTTBR 

will ■! arrays fr Dm previous pilul :; h o l ■ I id be erased. The user should type I^KS il his preceding 
plot is complete. 

PtXfTTEK i 

Display platted an current palter page. 

NQPWT 

The plo-tler as released. 

BISPAGE 

CXilline ol 7x11 page displayed as :PA&f! 

I*.U Pats 

Di4LS *diat-nv,mhrr> 

On I p^ts Ihf value at pal *diaF-nujnil>ir/> as s decimal (radian belween 0 end L Careful: INj 
numbers -an the pots ere marked in Octal, but LLQGO normally Aspects decimal numbers es input. 

I5H Points 

(Points are displayed whelhor or not the pen is dawn] 

POINT 

ftsplays a point al lho turtle: s CUaronl location. 

POINT 

Displays a poinl at sj,>. 

POINT ^lltrzp^ 

Oisptays a polnl *n at 

POINT ■ : ^nop > ’'if 11 

Displays a paint in et |*r> N 





15.15 Global Slate of llte Turtle's World 


For alt flF these Functions, the lint input is optional If left og|, the command roftrs to 

:PfCTURR by 


SETIIOMK <«frnr> 


ReSttS I Ur Ur’s hOmc |0 cur r col uOS-ibOn. 


SET If OMR <kfnp> <r> *y> 


Resets Ihe tyrlle's horn* to thfr absolute seope c-Oflrdmetcs 0< (**>,. Takes effect 

immediately by moving Ihe current iP/CTt/fff! to She new home. (SET7F0ME Sflf, Sit-,) 

restore* the home to She center of the sc r een. 


■ , -aei»rie> 


Moves s-imm-v goder the control ot space war console 1 Button terminates movement. 
The new home is returned, expressed m absolute scooe coord nates. IF the current home ia returned 
immediately and the space war console Is ignored,, cheek lhal all switches On the cOtOr scope data 
switch eytension are m the middle position. 


ffl.INK <nrrnr.> 


Slinks ^ wT-rjTn-"_ 


UN BUNK <jcniiir> 

Terminates blinking. 


BRIGHT ■ = srrnr , > 


Returns current brightness of as * number from I (dimmest) to S (brightest). 

Grdinarrly, :Tf-RTf,E and : PICTURE are at max mum brightness. 


BRIGHT ■''xcrrlrT' 3, 


Sets brightness Of to where ^feurT* is an inleger From 1 to S. 

SC4/.I? *jemw* 

Returns current scale of <jmnitp>. Soalfi i$ an integer from 1 (standard Stale) to (JG times 
standard sca’e). 


SC/HrK ^rernr:- 


Sets scale Ol ^aerne* to whore <n"te> is an integer from 1 TO 0. rji«> is a 

multiplicative scale f sclor. tie nee, SCALE S doubles the si?e ol an ordinary picture, SCALE 3 
quadruples it and SC/lLfC 4- multiplies Ihe size t>y 3 SCALE S restores, picture Id slanderd size, 
This is a hardware scaling and aFleds Ihe current display as well as Future disptayage. 


Display' Turrit lor Ihe 330 arid GT -0 
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The length of * turtf? step is resel It? f h-ni( , >. <*nfifjr> may Lie an/ feal number, Resulting 
iLvc scsle with OSt/IF.E ralhet than the pdvenlagc I h-pt Ihe stale Fat tor may be any real 

number. ttpwevc*, 0SC.i4.tfi applies only 1o future display and opt the current picture. 


Section SB, The Mili-ic Bok 


The music bo< >5 a lone gerkrratOf for from Cre fo four simultar’jftDus voices,, hawing a range 
of five octavo-s. Because Ol the Nmestiarififl environment, music is compiled info a buffer,, and then 
shipped fo the mijsrc tao* all at Once, lor smooth firmng. Wherever possible, these primitives have 
been made compatible with both those al I H.OG0 and CLOGQ. They made be used with the ”old“ 
(Minsky} music bos, or Ihe "new“ {Thornton box compatihie) music box. 


l&-[ PlujjgiHi; Irr 

Tq plug in Ihe old music box, find an EXKXPORT terminal. Plug it info a 300 baud US line. 
Using the phono type plug On Ihe lop right pi the EXECUTORT back,, or the acoustic counter. Make 
sure the terminal is turned off, and plug the music box into tne left back ol the E*ECUPDRT. {Or find 
this all set up m the music room on Ihe Ihitd Floor,} Turn oh the musk bo* and attached percussion 
box., and put Ihe fXECUPGWT switches info Ihe "line” and "uppercase'' positions. Turn on the 
terminal, typo nZ and log inte ITS. The panic procedure lor Ihe old music ho* {Symptom: keyboard 
dead but [T$ nol down) is to swilcti lo local lowercase mode, turn off the music bos’ and tvpe B 
Then type S7' 

When using fhp musk bo* irom MJ.T[CS, renumber Shat both carriage re! urn and line feed 
must be typed to end a line, when using an EXECtf^RT. The terminal should b* in "hall duple*" end 
"tower case" modes. The panic procedure described above is nol recommended, since pulling Ihe 
terminal into local node will have the ePerl at togging you Put Ql MULT3CS. 

PI USE ink; in Ihe imusic bo* is a bit more ol a problem due to I initiations ot present 
hardware, the critical item is a small pitot fll gletlrOnics known as the "terminal controller card", lo 
be had from General Tut ftp in fhp basement of 5^15 Tech Sciwe. This card is Id be inserted in Ihe 
tor roc! Orient alien in port 4 of a Thornton ho*, (tf you have never done this, ask! Put! mg i| in 
backwards will burn out |hc card i The music bo* should be plugged into port 1, 2, or 3, depending 
upon which has fhp mus c box card. {[) shDUid be labelled.) Thprt, plug the interface connector 'of the 
Thornton box >nIo- a 300 baud IT$ line, a terminal snip port 4, and log into ITS. The panrt procedure 
for the new music bo* is lo gel your terminal lo echo ri n0 " {contml-Q spacok Since Ihe normal 
print routines will actually send *u.f/nrrmr £f> for <enni.r(it-0>| ihis is most easily done wilh the 
"echo" gadget pf the Thornton Bo*, a smalt connector which makes Ihe Thorton iiux look like a Full 
■duple* compute* line. {IF you want Ho make yourself One, see General Turtle or Mark Miller; you 
probably wont heed it.) 


16.% Turning tin- 

Assuming you are plugged in and logged hlo [T&, you may now run either music bo* in LISP 
or LLOGQ. LLOGO will ask you If you want the music bo*i if so, il will ask you which one; if the new 
or*, it will ask you which port it is plugged info, After answering all questions, type ST'AItT'WWJC, 
]E will tell you to turn pn the music bo* {the old one witll triage a to! of noise), and Ihen type OK, 
Thpn, the noise {if any) wifi stop, and you a** ready to §.0. 

Thr music box can also be run from a p-„re L3$F. Type OfASI/iAt) MUSFC F/ISL DSK 
LI.OGO), and answer Ihe questions. Type (START MilStGl and I he Following prim'lives will behave 
like LISP SLfiRS or F$UBfi$. (tf you do EHKWST hacking, see Mark Wilier.) 


The Music Flni 
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16.1 Music Prim Hi v es 

A grt-at deal ol olFbrt has gene into injuring upward compatibility wilh CLOGO ard 1ILQGQ. 
]F you have programs Fat either of Ihcstt which no longer work on LLQQQ, please let i,m knew. 
No lice that many "irtt&rmcMdiatr“ level I unci ions such aa. CJffJIlUS, wh<Lb ■■ I! :d UtKrn wril’-rn in LOGO 
cade. Ate Jupplipd as USP primitives For elFiciehcy. Fn addition, new Facilities have been added 
which should be he pful. En the failowinji, all such situations have been indicated. Occasionally, » 
single function replaces several LOCO funtljoni.; I he other? are still available, but may print a 
message recommending the now^j function for future cade. S'nee most music Functions j|r C executed 
fflr afFecI, unless othetwi.se indicated, 1 hn value of a I unci ion is ihe Hlom {word} ?. 

ROOM 


Returns the number which ca-r respond:; to ;i rl':;ir brat. Using DRUM is more efficient. No 

inputs. 


BRUSH •'-dur&tiuit }in> 


Takes 1 input, a list of duration Plays (ie. slores in the music bu"Fet tor Ihe outrer'il 
voice) a sequent# of brush notes (see QRfTClI) Hnd rests. A duration at n means 1 brush lollowpd 
by n-l rests. 

CtiQRUS ■‘■farm 1> . ... *[arm 

Takes frpm one tb four inputs, which shotdd be forms [procedures with Arguments, Or 
constants}. CHORUS evaluates each argument in I urn, and then goes on Id Ihe next voice, rn cyclic 
order, and evaluates tbp next argument. Example: 

cuoRU.s si nc t ju si nc a rn 5 f,vc t iq 
PM 

If the number of inputs is the sarr-e as :iVt r 0ICK,$, sequential calls tb CHORUS or SI1VC will 
do the expec led things if the number of voices used by Ihe arguments is equal Id zNVOICES, 
recursive calls will also wprk. For olher situations, just remember that rPU/CE N updated alter 
evaluating each argument. For example, pf ;MWICES ~ 3 and you CHORUS two calls Id .?f.VG, the 
next call to CHORUS will alfetl voice 3 r 

CHORUS? c -f<yrm 1 * <form 2~ r 

Version of CHORUS wh'ch lakes edacity two arguments. For upward compatibility Only. 
CHORUS* ‘-farm U *f(trm £> c/srm U 
Amaip£0u£ 10 CftttfHJSl, 

ClfORUSl '-firffh !' <fnrih 2* <fnrm *> <farm t> 

Analogous 1o Cff0K[)S.l. 




BRtvAf ^Jij t nf durnlii;^ 


AnalogCy? |& pJM/SJf For drum noles (see ftflfJM). 


GRfTGH 


Returns the nunvhet c-orres pondi-g to Ihe brush sound ol ihe percussion speaker. More 
eflicient Id use tttitj^if. 

M /l #£ E1%! iVf? ■^rurn’ n^?n-r> 

Takes as inpul a nante, I ke UCOO or LISP SKF. Ft muttip“eces the huifer and Save's 

il as the "thing" <s1 the name, Thai is, it stores Ihe tune as data, tt opposed to procedures. This 
allows Faster playing, (see Pi.AYTVb'K) and easy storage (SflT'Fd with other LOGO variables,> Since 
M /Il( FT iVft does rvol c oar the bu^Fer, allows saving and playing i-ncremc-nlsilly larger portions of a 
r&pig piece. Tunes made on one music bd* can be played on ihe other, w>th the exception that tunes 
wdh exactty lhrwtr voices can never be played on Ihe new music bo* (see jV^OICfifi}, M/lKRTUfVK 
ded nol e*is1 in CLOGO or 1HQGQ. 

mrufclean 

Wo inputs, Clears the music buffer, and starls at voice t. This should be done lor example, 
jilfcoT typing, /\G to kill an uroleasant song, or attrr WflKATIWfiing the final version oF a song, 
be Fore starting a new one. 

,W HVFCOUNT 

Same as KAiITIV. 

MtWFINiT 

hto-Oo. Prinls nnessage to let you know you Iried ta use this relit ol Ihe past, 

MBUFltEXT 

Ms-0P (See IfJMiTf JJVfTSi 

M RUFFVT 

No-O-p- (See Irot/Hivir) 

MtiUFQUT 

Mo inputs, Ptays the music butter. Does nol dear it. 

HLLEAR 

Seme as MttVFCLRAH. 
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MLE JV 


Returns the dciraticin □f the tQngcsl created 10 far (since the task M JtL/FCKrltf}. 

Lkeful fo* budding procedures such as percussion accompanur-enti far arbitrary length tunes,. {see 

MOTHfVSfC *T f*r WIs 


Takes one inpul, Nil. or otherwise, [' non-iVJJ,, puts music in b mpde where oumtiering is 
fftshi 0 to 5A, arni note 60. is the same as rote 0. (i.e., (note mod SO)), ftp that one need ndt worry 
about exceeding I he range ot the mijftic bdT, 

NKirhWS fC 

No inputs. Informs system that yOu wish tb use She new mask bo*. Asks which part music 
Imk ie p^wEaed inlp. fJ;irn'?iiy user wit nol rv^ed lo call JVElFitffTSiTC, as die quest lonn^ir-e at |o,>d 
time suit ices. -Seo: QLDMUSIC. 

NOMUSIC 


No-op. See XfRVEPltT- This function may be reinstated as a way lo excise Ihe music 
package, for example, when one wards to load the turtle package instead 

NOTE € pilch' y ■CJiiixriron 1 ' 


UnforlunaleHy, (through i» fa»i1t of LlOGOt, there are minor variations belween 3 tLOQG and 
CLQGO. The rtiff^rpnoc between NOTE and SING •■s one such problem. According to the t EfQGG 
Userr "s M^nu a I ,Vff Tfi is the bas e c LL. JGU rr-uiic command. 3t takes, two inputs, a pitch and a 
duration. It numbers pilches chromatically from -J4. t-a 36. with 0 being middle C. There are also 
three special pitches., follows; 

-2& is a rcsl 
-27. r* a boom 
-26. is a gritch 
-25- it illegal. 

11LQGQ NOTE cart also take mulliple inputs. LLOGO music has implemented all of this for NOTE, 
esitep! the mulliplp inpuls The numbering is slightly different irom O.QG0 $h\C, which is akso 
implemented in UOGO. (tee: StNC). 

NVOICES *nu nr^r-o/■«(»(> 

Takes one input, hopefully a number between ] and 4, Sets ilWQtCES to that number, 
dears the buffer, and sets rTOfCtf Id J. flemember 1 hat 3 voices is illegal on Ihe new music system, 
and wilt generate an error. [1 rs generally better to usk (our voices, blank, sn that tunes win 
play cm eilher music bent. Tn XtO ftXtUSIC T mode, (eOrmaSly nol the case}, calling NVQICKS wilh a 
number outside <5t [IAt will no! cause an error,, but teerrts craey. The 1# Input mod A wllf be used 
instead. SKTing -.NVOICRS □- *f/Ifc^ing "JVI/tf/CES" canned be prevented, but is considered a faux 
pas. Accessing zfHVOKKS is welcomed. Calls MIHfFCLK/IR and resets &OICF, to See: 
INVOICES. VOICE, VOICES. MOOXfUSIC. 


OUlMVStC 


No inpuls. Puts system in mode for old mutit box, Normally nol needed by user,. as 
questionnaire al 'oatfj lime Sufi it Cs. Might be used, Fur example, if you made a mistake answermg the 
questions. See: NKlT MUS 1C. 

PKRTORH ^W} 

No inputs, Outputs thp music buFler, end Ihen dees an MRi/FCLRAH. See? HM/FGUT* 
MmJFCLHAti, Pt.AlTI/NH 


PLAY TUNE <tuvo> 

Takes One input, which must evaluate Id a tune crealfcd by MAKETUNE. It plays Ihe tune, 
Does not ties# or otherwise *0er the current music buiFer. PL/IYTIINF, is transparent to (he 
current number Of voices,, even if the lune uses a dflerenl number. Soe: MAKETiJNK, PM. 

hi:ST 


No inputs. Re I urns Ihe number ul the nol* which g.unrral^s silence On the music boy. {Like 
/JfHJ.lf and CftlTTiW, this will win independently el whether l ] LOGO or CLOGQ primitives are being 
ur.nrti hkcwrse, ►! will be Ihe correrl number for T Or hQrmal slate, even lor different 

stalebases.) Naturally this (becking is less elfrcienl than just calling SfAFG -IS. or NOTH -2S. lor Ihe 
appropriate duration. See: SI KG. NOTH. WIMUSIC, iSCALHRASE 

RESTARTMUSIC 

No inputs. Like STditTIftJSfC, exte-pl fe-*nllialt?c$ all syslem variables, and runs 
questionnaire as far bath as s*king which reusic box. Useful in situations ol total Ipsa after panic 
procedure. Usually tunes erealed by IMX£T[jiV^ and user procedures will be intacl. Oufiec w*ll 
be wiped Out. [n cases of peculiar behavior al login or load lime, guarantees that everybody thinks 
they have Ihe device you Ihrnk they do. Jl this does not work, go to "PILIGGING IN", 

SING sj*iie^ 

Sasic GLOGO and LlOGO music command ^akes IwO inpuls, a pitch number, and a duration, 
[f rs highly recommended that dural ions be integers greater than Q! Very large durations (each pnrt 
corresponds to a character alom in USP) are *p! to slow down Ihe system a lot r so smalt integers 
arm highly advised. Pi I c he s a r e Iron 25. to 39. r wilh 0 being middle C. (But see the remarks ,-ibOul 
J 1 LOGO’S variant, NOTH, and also :SCr1Mf|lrlS^' ard MOflMUStC ) Pitch -26. is a rest, ’-24. a boom, 
-23. a tjriteh, -2?. ignored- Out see REST, BOOM. GHITCSI 3 Dural ions are normally broken down 
mlO INI-1 beak of pilch and 1 beat of rest, to avoid slurring the music. However, if the SPHClAt, 
variable -.{NSTftl'Ml'\T is. "i'lMCCfl'/'i'.l", L bcal Of nolo Followed by N L beats of rest will be sung, 
(i.e., stored in Ihe music buffer under Ihe current voice). If olher phrasing | S desired, it may be 
added later. 

$OJVC Spiirfti’iJ" sdarneifl.nji> 

Takes two inpuls, a list ol pitches and a list ol durations, Calls SING, pairing pilches with 
duration* until the shorter list 15 exhausted in other LODOs, (has was not a primitive, but was 
written as a recursive LOGO procedure. 
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ST/l^rWL^fC 


No inputs. Should he railed Id lurn on Ihe music box. Unlike CLQGQ, it pauses Id lei you 
Sum op Ihe bD-x, to minimize Ihe ur.pleesan1 noise gerwretiOn Op Ihe old music box {PURFORM alone 
will suffice). Clears Ihe musiL buffer and sets ¥(I!LR to L. Probably unnecessary with new mus ic 
box. 

VUS1 v 


No inputs, Return* duration pi current buffer. See: MlJl/fCOl/JVf, 'MAX, WfJfW. Useful 
when chorusing a tune with arv accompa'Mmenl. If (he accOmpanimenl is Ihe Iasi argument to 
CffORt/S nm(t tOntiiirt* a stop rule like, 

IF VLEJV =■ If TEN TURN STOP 

the accOmpan monl can be usod with arbitrarily long luties, 

VOICE *tm iee> 

Set* zVOICR to its one input, provided Shat input Is a positive integer less Than 5. If 
greater than Ihe current number Of voices, NVOIGRS 15 called I'O increase the number. All it ur.it 
from now until the pent call So VOICE (or a primitive like CHORUS which calls tfllCf’l will go into 
Shis voice. All Ihe voices ip usd will be rmiHrpbxt-d prior So P^IEFOfiMinj the buffos, In 
MOOWL^VC T mode mpuls greater than d. da not eouse error*, bul are simply cycled through the 
allowed voices. ftMAfEing {LLQQO) or SATing {LI$P} A'DiCE is nol pice. 

i^rjfCEs 


No-op. See NOMUS1C. It anyone has a use <Or this whkh is reasonable, e.g., iynOnym Spr 
iVECJJCES, we will be So impleme-nl it. 

INSTRUMENT 

Spetiill system variable which is user sellable. Its value determines the behavior oS MITE 
ard SING as above. Currenl meaningtul modes are LEGATO and STACCATO. Anything Oise ii 
considered STVICCdTO lor now 

rJM.V 


This pscuch? vari^h'e >s actually * t*H to MhRN, above. ft exists tar eampatibiHty with 

CLQGGL 

VOICES 

Special system* variable, not Id be changed except by catling iVl'TMCEiS. LI telte you the 
number of voice:* being filled or played ;:l preienS. Delauit is 2. 

rVOiCE 


Special system variable, to be changed Only by call ng p'piCE. Tells you the current voice 
that is being filled. MBUFCLEAR resets to I. Always initialized to 1. Can be changed by call Id 
CfiORl/S. 


SCsVVtiSlSK 


sy-slem variable ^vhich may Eh? changed by user. [I [*ll? the offset Ir&m middle C to 
bo used in renumbering nolei 1o one-, tactc. DglauH is zero. 

The IJLOGO music iunc'iorm MLKHTL, MISTY0, and MIMAtT are not implorne-oled in 

LLOGO- 
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Srctiom IT. ni aplay Tunk f or the K night TV Termin ate 


In addition to the diE-play I unfit package lor the 340 and GT4Q displays, t.LQGQ ^tsu 
pr&vido? licililios far graphic? On the Knight terminals, raster scan televisions controlled by a PDPll. 
Theso terminals provde a number of advantage? lor LOGO graphics ever vector -mode refreshed 
CRT’s like the 340. Since the picture which appear? on a user'? screen is tlsrM to the I it memory,, 
one hit per ooint, the user can put up arbitrarily complicated ptlures containing any number of 
vectors, without causing flicker, k is possible to use pattens of poinls to create shading effects. 
Commands which deal more directly with displayed images, ralhpr than through display list? car be 
implemented. Programs may test individual points being displayed, without recccsitaling compulation 
ol intersection cl vectors. The turtle is supplied with an "eraser" in addition to a "pen", A capability 
which would p-rove di+iicult lo implement in a vector display. A split screen mode is provided to 
fan'ifatr inTeraction hetween graphic output and character output Item program typeout and error 

1110 5-i 


As iS the case with (He other LLQGO special packages, the TV lurlle is available as a sel oi 
LISP tunc I ions which t&n be used in an ordinary LISP. wilhOut the remainder ot the LOGO 
environment, The TV turtle can be obtained in a standard LISP by doing rf/lSf/i/ID TV RITE F/1SL 

nsk u.ocok 

The primilives available are designed to be as compatible a? passible with LLOGO's turtle 
commands lor the 340, end | \ LOGO’S. Some deviance from prior implement ah-ons of the LOGO turtle 
was necessary, however, to lake wlvanlige ot the unique Features, and reaped the irmitalions ot the 
device. Most of the incompatibilities are noted in I be descriptions oF the primitives below. 

ST/imifSPW S5i?| 

Initializes the screen. The user is supplied with a single tintt#, located at the center of the 
screen, with its pen down and an initial heading of jfero. $T’dFfrOf5Pf J /15 ,r puls the user in split 
screen mode. Program output appear? at the bottom of the sCriyen, and pictures drawn by the turtle 
commands appear withm h displayed bos in 1 he upper pcrMon ol the screen. The sizes of bolh the 
program and display sroa arg rhangeuble by the user Thus command is also unelul at s mean? of 
reinitializing and restarting everylhinp^ -when- things get hopclns-sly foiled up. ST /!RT’^RJ5PEf1t , 
should restore Ihe e ntke state of the lurlle’s wprtd 1o whal it was initially, 

NQDI5FLAV {JVflj 


Announces the user's intention to stdo using turtle primitives. NODISPLAY terminates Split 
screen modo, so that printed output may occur in any pad of the screen. Turtle commands executed 
after a lWJO/SPMY r will cause graphs Output Id appear, but no assurance is gi^en that graphic 
Output and Pointed oulpul will not interfere wilh each Ollier. NODfSPL/Ji also clears the screen, 
Use CLEARSGFKVH if you want to relurn to split screen, erodo alter enecuting a NQDISPLAY- 

SAVEtllSPLAY 

]f you sail trPm yOur LLOGQ or LtSP by a/ white drawing pictures with the TV turlle, you 
will lose the picture drawn on the screen, as well » possibly leave the program in an inconsistent 
state- To prevent toss-ages Ol th»? type, the primitive SfllTTjf.S-PJj/IY can be used to exil gracefully 
from Ihe program without losing a piclurti drawn, SAVU&l&PLflf will leave you in DDT , and when 
thn I LOGO or LISP is continued, the display area will bo redrawn and execution continued Irom the 
point at which it was interrupted. 




17,| The Turilr 


The lurSIp marker is displayed as an iseceles triangle. with a line from the center to the 
verje k between Ihe equal sides; this line comt* in ?!>e direction of Ihe heiedinp,. The triangle turtle >s 
X0fi*cd in with the displayed picture fo show or hide the turtle: points which are displayed when the 
turtle is not over Ihem a r e turned ofl, and points where nothing is displayed are turned on when the 
turlle ■= ovtr 1 hem. This ^1 lowo lh® turtle lo be moee visible against i background consisting ol a 
complex picture, or shaded area lACQO’s TV lurlle provides an extra bit of information fo Ihe user 
about the turtle 1 ?: state: The renter of I he firiangfe inchcales what wilt happen iF the turtle is moved. 
9F Ihe pen is down, a Idled- in box is displayed al the center oi the triangle, ]f (he eraser is down, *n 
Outlined box appears. ]| XQS mode is <n el Feet, an l Y H is dispayed at Ihe center pI the turtle, (f XQR 
mode ii not ir“, irtfetl and hath the- prr> and the eraser are up, Only the Iriang’p will be displayed. 
This state indirales lhal the turtle will not draw or erase lines when moved. 

llIUMVHTtrK fJin 

Makes the turtle disappear. Only lines drawn by the turtle will bo seen, and nr: marker will 
bo drawn lo indicate the turtle's posilion and heading. 

StlOWTVKTLK [$T\ 

9r>ngs Ihe turtle back to lite. A turtle marker will be drawn to indicate the slain of the 

turtle, 

ifjWtmjRTtJ! 

A. global variable which is T if Ihe turtle is being displayed, else NIL. Don't modify this 
variable your^ell using MAKK or S K7Q< Thp value should Only be changed by calls to 
IIinETVNTIJl and SIf DIP TURTLE. Unless explicitly slated otherwise, Ihe global variables 
mentioned in this secMon, such as rXCfJK, -.It It SWING, a-nd :PENSTATE y should no I be directly 
modified by assignment. Use instead the 1 unctions which are provided for thal purpose. Mole that 
M S}K ft’ will npl let you modify a variably that is used by Ihe llOQO System. 

M /IKFT'LfRTf.K ■ c drnu\-lnrlfr-iirwr(turr* *-vmxr-ltLrtlr.-ptvwJitrr> 

This allows the user lo substilule procedures For drawing the turtle marker to be used 
instead ol the system's delault triangle turtle. This lealure coul-d be used to substitute a more lifelike 
p«clure to represent Ihe turtle, lo print slate information on the screen instead of drawing a picture, 
Or to recOfd I he turtle’s wanderings, M SIKKTL'RTLH tales as input the names Of two procedures, 
the first lo bd tailed whenever the system wants the turtle lo appear, thp ac-COnd lo be called when 
the system wants the turtle marker to vanish. These procedures will be called in :$RRT(.. I RTI.E mode 
when ihe turtle's stale changes, i.e. by FflHfr/JRP, RICIfT, PENBQIFN, ott, the procedures, should 
examine Ihe turtle state variables, such as XCfllt. TtfJfl, -.MR/IDING* ‘PEN$T/lTF r etc. lo decide 
hpw end where the Turtle marker 15 1-0 be displayed The procedures will be executed with 
:$EKTURTI.E bound to NIL, to prevent intinite recursion. All turtle stale variables are rebound 
during the execution or user r.npp ir::! turtle marker procedures, :;0 thal yQu tin change theirt in the 
course ot drawing a lurftp. 

]f there is more 1han one turtle, each turtle (in be given a separate set of procedure* for 
drawing and erasing itself. 
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:DH/tW TURTLE 

Global variable fOnSaming Ihe name of (ho procedure being used to draw the current turtle. 
Wt mears Ihe standard system 1ri 3 r- & | c turtle is in use. Set by *1 AKRTVRTLE. 

PRASETIjKTIJ: 

Lite :I}R/HFTURTLE, but contains procedure used to erase the turlle- 
TFI/ISGUHVtlTrE 

The procedure used to draw the slandard system Iriangte turtle. ]f ytsu want (o do 
something just slightly di!Fgrpn| Ih-an Ihe standard (urtle, you might have a procedure- whrth tails 
TttiRTt. R-. Since TRf/lftCLETt.fRI'f.K draws Ihe turtle in HOfl nO(Se, the- samr procedure 
n Used both to draw ard to erase (he turtle 

| 2 -J M-oViirji the Turtle 

FORWARD J 

Moves Ihe turtle ^ifejuO in the direction it is currency polled. 

BACK 

Moves Ihe turlle opposite to Ihe direction in which it is pointed. 

SETX <x> 

Moves Ihe turtle Id VCOtf). 

5K7T < r > 

Moves the turtle to (AGfJINL *>*). 

SisJ'XV <i> <y> 

Moves the turtle to 

delx *<**> 

Moves turtle to ( XC0R^-4x\ YCOR). 

UtiLlF <£y> 

Moves turtle to (ACftR, 


DELX y -dt* *dy> 

Moves turtle 1o YQ0F*<iyH 



HOUR (If} 


Moves turtle home to He Berlins state, at {Q, 0> with » heading ol 0. 


WRAP 


Move trip n( of I He turtle paid the boundaries ol the screen by fOHW/llW, SFTX ¥, etc. is an 
error r op.ks.s- WRAP is tlpnc This causes movement of! one edge to result in Ihe turtle’s 
reappearance at the Opposite edge, as ■! the screen was a Torus. 

imiFft/ip 

Turns off wraparound mCde. NQfFRAP makes sure that tUr turtle’s wordiruta are within 
tbp boundaries ot the screen. 4hy subsequenl altempl to move beyond the bourdanies of ihe 
screen will cause an error. 


HAP 


A global variable contain,ng T iff wraparound mode is in efkct, /VfJ, otherwise. 

Currently, the turtle always draws vectors in- a prelprred direction i! draws a fine between 
two endpoints the same way regardless of where the turtle ■$. This- is just an elfrcicncy hac*.i it’s not 
even noticeable when drawing short vectors Of On those rare occasions when system load is tight 
and the turtle «& drawing rapidly, [i this peculiarity proves annoying, to many people, it will be 
changed tb draw always in ihe direction ol the turtle’s movement 


I7.J E ras ing the Screen 
IFJFK 


Erases the picture on the screen, except that it docs not affect any turtles which are being 
displayed. 

CLKARSCFEEH [Cf>) 

Equivalent to HOWE lFIFE, but faster. 


IT -4 Turning the Ti trrte 
KlGttT <anglv> -| FT] 

Tyros the turlle dockw.se ^(ureTe* degrees. 

LBtT ^hflnv ]£T1 

Turns Ihe turtle counter-clockwise degrees. 
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SETff 

The turtle it turned to a heading of 


17.5 The Fth 


Ff-snoir* ■ f d] 


The I or Ha’s pen i? lowered. This means that if Ihe turlle is moved, a lirve will be drawn 
between |h«> I ur tie's eld and new poaiiions. A filled in ton is displayed at the center of the turtle il 
in SIIQWTUHTUZ mode, to show the user that Hit pen is down. 

PENVP [PU) 

The pen i$ raised. The turt'e will not draw a line when moved- !f SfKnFTLi'firtE mode is 
On, the filled in bos displayed at Ihe tenter ef the turtle to indicate PENlKitFN will disappear., 

rPENSTVITJi 

A global variable which -,s T iff the pen k dawn, else NIL, 


17.6 The Eras er 

A unique lealure ef Ihe TV turtle is that as well as having t "pen" which can be raised or 
1-0 we red to conlrol drawing of litres when Ihe lurfchr is moved, il also has an eraser . tMnen the 
eraser is down, it the turlle retraces a line which has been prcv»oosly drawn wilh the pert down, the 
line disappears. This rain Also be fho'j&ht Of as ’drawing in Ihe same color ink as the background'., 
tyoln that this means that it a line is drawn with Ihe eraser down, any poinl lying, on lhal line will bo 
turned Off, even though anolher line mghl have passed through the sarre point. 

BK/ISEHDOIF iV {JTRD} 

The eraser is towered. When Ihe lurtle moves, lines are erased which were drawn with Ihe 
pen down, nplr that the pen and the eraser canT be down at the same time. ERAS&R(KNFN 
therefore wil 1 aU t>mal ical ly do a PKNUP, and PF/N OQIFA 1 will do an felf/lSKJtf.j'R. An outlined box id 
displayed at the center ol the turtle when in SHVWTVHTf.F. mode as long as f 'i.' eraser is down. 

RR/tsuffUP {ft’ify} 

The eraser is raised. 

*ER/1$ ERST ATE 

Gfobal variable which is Tiff the eraser is down, NIL otherwise. 


]7.7 lowing in XOR Mode 

tn addilion fp drawing with the pen dbwn, which furns on pOmls along the lime being drawn, 
and drawing with Ihe eraser dbwn, which turns qH pOmls Mpng the line being dur**^ there exisU 
aocitlier option, '.se f ..il in tfrlain ci r c=. rst a"ccs t ”<j tu lle can oe used In draw in mode -- 





points iitong Ihn linr bring drawn ?tr k turned on af they were previously oft, and oft if they were 
formerly cm. Th'S mode Of OPerahon is used 1o display 1 hr? trisnglp turtle in SJfOlfTtJ'ffTEJJ mOdr. [I 
allows the same procedure to d^aw a line and erase it, leaving what was there before it undislurbed. 

xmmwN ?\T} 

xqrup i *(/) 

iXORSTATH 

Analogous to ttve corresponding primitives for the p gn B nd I he eraser. 


I7.it Ex a ret mi up a nil Modifying the Turtle State 

zXUW 


A global variable co^t.n ninp, Ihc turtle's current X location. X (.oordi nates increase rightward, 
an-d the origin is in the center of the screen [bu - ran hr- rnanp.r-d via SfTtfOilE]. This variable is 
always a floating ppinf rrumbrr. Cl wraparound mode is in efted, this variable indicates distance Irpm 
the Origin as if on an infinite plane. It the -ighl edge bf the screen Is 500, and Sf7X 600 is done, 
writ be 600.0, but the turlle will appear 400 kpnts Id the IcU fll I he origin, 

;YCOR 


like rXCTJf, but holds the value of the Y coordinate. Y cbOrtfmalca Irttreiti upward- 

: II RADI NC 

Holds the value of the turlle’s heading, in floating point. A heading ot zero corresponds to 
painting straight upward, and hesdmg increase; clockwise. This varrahle always gives Ihe absolute 
heading, net reduced modulo 360- After SRTftEAD iM. ME/)0iW is AOO.O, not 43,0, although the 
fur lib is pointing in the same direction as BETltEAl} 4Q 

XLOR 


Outputs the X coordinate ul tty? turtle *= an integer. If wrapaound mode is in eflpcl, (his 
function will output the position ol Ihe turtle as it appears on thr ■screen. Alter SETS' fStlO, XCflH 
would return -AfKI 

I CQH 


tike XL’Off, but outputs Ihe Y coordinate ot the lurtle. 

HEADING 

Outputs the hendina of the turtle as an integer, mpduk 960- fitter SETH E AD *00, 
HEADING would return fit). 
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Outputs f-Ji" h iV| f, iVCft XCttfi PCOfi HfJTlOTiVC J. I hit* I ul tpr f-p-mpmbipr mg [he turlle's state 
via itf/lKE TL'HTLfc’SOrff WOf.’ A turtle state saved in Ihis manner tan be restoring using 
SKTTURTLK. 

SEftURTLK <uaui> tSETT;- 

Sets the state of Ihe- turt'e to *'*rnir> it a sentence pi X coordinate, Y coordinate, 

and Sheading. The heading may be Omitled, iri which cate it is not afTected. SETTi'RTl.E is the 
inverse of HERE. 


I7.R Multiple T»rrle* 

Initially, the u'.ei is supplied by LOGO with One unique turtle, which remember* its posilipin 
and heading, and it capable of drawing or erasing lines when moved. The atrNSy In create any 
nuntber of these creatures and Id switch the attention q! the syslem between them makes possible 
such things as assigning a lurlle Eocally to each one of several progr*™^, 

HATCH <tu rife-Jinnht> 


Creates » new tip-tie, christened ^ih erfy-flamr>>. The turtle created by HATCH slants Oul id 
a Stale identical to Ibat of the original turlle present aMer a »TARTl)ISFLAi'i It is located al Ms- 
home. at the center of the cton-play area, 4s heading points straight up, and its pen is down. The 
newly created turtle becomes Ihe current turlle, and wilt respond to alt turtle commands. The state 
of any previously treated turtle, including the one originally supplied by ST^BTfl/SPL/IT, remains 
uraftected by HATCH, or any turtle command referring to Ihe new turtle. 

USETURTfrE "-in rl fa-jtit r?i eo (t/T} 

Selects Ihe named turtle Id be the Cement (wile; this means that all subsequent lurlle 
commands [EORWARf), H(GHT r ...,], and turtle si ale variables [AiEADlW, :YCOR, :YCOR, . . , 
now will refer to the selected turtle until changed aga n by another call to USETURTLE or a call to 
HATCH. The stale of the previously selected turtle is preserved so thal if it is ever selected ftg*in, 
ilt stale will be restored. The turtle which is prpvicted initially by STANTDiSPLAY is named 
i&GOTVRTEE. 

:TURTLE 

Global variable which contains the name of the currently selected turtle. 

:TJ:FT!.ES 


Global variable winch contains a list OF Ihe names of all the turtles in existence. 


j?-|l) Global Navigation 


HEARING, RANGE, and TYJtTvlflfJS return integers if al! inputs are intcggr-Sj otherwise 
They relurn floating point numbers. Tin? numbers relumed are always positive, and BE/H?/AfC and 
TOir/l flDfl return Headings modu'O 3GD 




RANGE 'i> 

RANGE 

Oi i fpL. f I hp distance from Ihe turtle lo * pprtit spc-cifis-d e«ther by I wo inputs which are x 
and y cQP-r d mel-e-s respectively. or by a senl-e-ncc n-l * and y coordinates. 

ffE/MJiVC **> <y* 

HE AKfNG (lemcM*®/-1 -^kJ- y > 

Oulputs the absolute direction from Ihe turtle to a point speeKird in * form?) acceptable to 
RANGE. fSETlfftfllf {REARING <y*\) points Ihe turde m the direction P< (■c*> ( <y>} 1 

TOWARDS < x > < y > 

TOW ARDS <J»!IMnr*cir-o/-E-nrnf-y> 

Outputs the relative direction from the turtle to the point specified. (RIGHT (TOWARDS 
< y^}} points the turbo m Ihe rjirecton gl {■«*>,, ^>]i 

I?.II Triggnomclry 

COSlNS *<ingl?> 

Co-sine Of Wangle* ceg r ees. 

SINE 

Sine of Wangle? degrees, 

ARCTAN <y> {ATANGRNT) 

Angle whotp tangent 15. i n degrees. 

[■S/V, COS, and AT AN are the corresponding functions which input or output in radians J 


]7.!?Text 
MARK. <(«!> 


Similar Id Ihe UOGQ command TV FF>, etrclpt I hat the tent '5 printed in the display area, 
beginning at |h* furllp + s current location. When- running the TV turtle from LISP, PRINC is used to 
print Ihe lent instead of TYPE. 


1?.13 Poi nts and Cir cles 

[These are displayed whether or not Ihe pen or the eraser is down] 
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FOlNT 


Displays a point al the turtle’s current location, 

POINT <T or Mf> 

Turns the poin1 el IfKKEv n it rts input is not iVIL, oFt it it is iV/f* 

PVl ST <x> <y> <T «■ IVI !.■- 

Turns the point a I t^sr 5 , on or o!f as specified by ils input. The third input is optional, 
and defaults to T [s.g,, I urn the point onj it orr.itled. 

Note: These convention^ For PO 1ST biflpr slightly Iroir I hose used in the H.QGO 340 turtle-, 
to accommodate the capability of turning a pcunt oH as well as on. 

POINT STATE 


F?cturns T or Nil* depending On whether tht point at the turtle’s current total ion is on or 
off The Iprlie marker is hidden tempersrfly during the execution Of POINTSTATF, to that display of 
Ihe turtle will not inter fenj wilh the point be*ng tested. PnliVTSX^rf wlH return * he I her 1h B poinl 
being tesled is On, regardless cl how it was caused IQ appP-af -- by a line drawn by the tufllo,, te-srl 
printed, shading, etc. 

POtNTSTflTR <x> <y> 

Tests the point al Ihe specified coordinates. 

ylHC , -'roifria.j > 

□raws an arc of a circle □! the given radius, and extending lor the given number oi degrees 
around the circle cenlerec on Ihe turtle's current location. The arc d r awn begins at the poinl on the 
Circle where Ihe turtle's heading is pointing, and is drawn in a clockwise direction [in Ihe direction of 
increasing heading], 

CIRCLE 

Equivalent lo /1HC ^raditti 3 " 1013. 


1714 Sealine 

Two functions arp provided far changing Ihe size 0* Ihe graphic display area al I he Top of 
thr screen and Ihe area Fur type-ir, anil typeouF at Ihe bottom e?F 1 hn screen, and Ihe d intensions of 
the display area us turtle caordinates. TVSIT.P controls the actual s^e Of the display area, and 
operates in terms Of r? 5 | B r display points. TlIRTf. >s used to e-slahtish Ihe mapping IrOm the 
specified TV SITE into turtle coordinates -- th* numbers given to and returned by the turtle 
primitives. It does not have any ofleet on the visual size of the jrri used for graphic display output. 



TVSIZK 


Returns a list containing the horizontal a,nd v^rtirfll sizes of the display are? In rg^tei- 
points The deFault ■size is 300 it 300, Ths dimensions d 1 Ihe entire TV screen ere 465 [vertical] k 
576 [horizontal], 


TVStXfl 


Sets bolh Flit *iflriftinFal and verlicei sires ol the display ema to fpicd? -jifn!* Mochlying the 
TVSJZE causes a (77 /1 FSCRtiF.N to be performed Ttet sue ol Ihe a r ea at Ihe bottom of the serpen 
(Or typeirv and typecut is adjusted Fo r n<i: up much space as possihlc on Ihg screen not being 
used Tor graphic Output. Changing Ihe JVSIZti will nol have any eMed on pictures previously saved 
by ,*M KRif WJiQW [see Section 17.I6J 

^SF^Ff ^new-Sf-rfi* 11, (nrir y-*icr> 

Sets the horizontel nnd vertical sizes independently, |f edheT oF Ihe lwc inputs i-j Nft*, the 
corresponding r,i ze reniains unchanged. 

TVRTLKSfZF, 

Returns a lisl containing |he horizonlaF and vertical Sires oF the display area in turtle 
coordinates These are in floating poinl. Thr mitiji deteull is [GOO x 1000, and the origin te always at 
Ihe center of the serfren — 50 turtle coordinates initially range From ^fjOD lo +500. M wraparound 
mode «s in eFleet, turtle coordinates are allowed above and below the range set by TVRTLKSiXK, 
and will bo mapped to appropriate pcmls cm the sCreer. 

TlJRTI.HSt/'K ■cpm-m-ai 

Sels the dimensions a* the screen »n turtle coordinates fo ■rncM-attc 1 ’ turtle steps. If the 
display area is not square [that is, il the hor zonla* and vertical TV size parameters arc not equal], 
then Sjiru.-.di** is loken lo be the nuitber of turtle steps for the m nirrum dimension nF the servers, 
and the other di mens ion is adjusted accordingly, tn particular, you can 1 ! speedy TIJftTLKSTZF. 
i independently in each direction, so that a turllo step always corresponds to the sam* number of IV 
points. Changing Tl/RTt.FSI ZR has no eFted an the picture currently being displayed, or on any 
pictures saved by MAKFW1NDQIF 

StiTHVMF {n/RTWifoutF. | 

StiTHftMF, <ttr.u‘-z-Famifr t-Hiip.-y-fiortif 1 '* ■jrFf) 

Changes the on gin ot lyrfte toordinates lb the spec f* Ed location, defaulting to thp turtle's 
present position. Thai posit-un on Ihe screen will Ihen correspond to an JfCfJft and YCQR dF zero For 
all subseouenF turtle commands. The home local ion is local to each tor tie, so (bat each Ol several 
Surttes may be ess/goed different homes an the serpen. 


17. (5 Screen Color 


The Knight terminals have a Facility tar easily changing whether bils which are on .n the TV 
memory will be displayed as dark or lighl On the user's screen. By analogy with n photograph, in 
"negative* mode, points which *re On [g r anhics and texl] will be displayed as light pn a dark 
background 3n "positive" mode, they are displayed its dark on a light background. The current state 
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Cl a user's trrmnal tan be complemented by typmg <£$£> C. The following function* allow it to be 
examined and con! relied by * use f program. 

aitot&TATE [cestj 

T iff the user is in "positive' 1 mode, Nth if in *n£ga.1ive h mode, 

GOWRNKC/ITtVK jLXiV) 

Puli the user in negative; mode-, we. light text end lines bn a dark background. This is the 
mode in efFeet in bally at login two. 

GOWRPOSJTnF. [CEP! 

Pijls the user in positive mbdeidark lent and pictures on a light background. 

COWHSif tlUi iCiW) 

Com pte merits lhn CjCtimSTATE, it I he currenl mode >5 negative, switches to positive mode* 
or vice versa. This has the same offc*! as typing C on I he terminal, 


17 16 Saving Pictures 

In creating pictures which consisl oi repeating patterns oi smjilinr pidures, and creating 
animated cprlOdns a il is often usetul Ip be able to save dinblayed pidures drawn by a series of 
turtle commands, and operate upon them as a unit, displaying and erssrhg them, moving them to 
Other parts p( lhn screen, etc. The LLOGO TV turtle provides such a facility, allowing the user 1o 
save rectangular portions bf Ihe screen a$ arrays of point e. These arrays can he displayed and 
erased at any location cm tbs screen, although they cannol be automatically rotated. 

This facility is somewhat different from the SN/1P cbmrriuid m the L.LQGQ 340 turtle and 
1 ll.QGfr The 5.V/1P operation saves thp picture as disp l ay lists, essentially a vector representation, 
white the TV turtle window saves an array ol point*. For large, sparse pictures, the vector 
representation consumes Toss spate, while the- point array representation. layers Email, complin 
pictures, Saving point arrays makes it possible to redisplay pictures much more rapidly than 
rpitrawing them with the commands used td originally ge-'wrate the picture, cince recamputation ot 
points lyina along vectors is unnecessary. It «e therefore idba'l lor programs which want to make only 
tew, spatially localized changp* to a picture, but need the maximum possible speed for dynamic 
updating ot the screen. It also has Ihp jidvanlag* Shat the amount Of space and time used fbr 
creating *nd redisplaying pictures is insensitive fo |he tompie^ily ot a picture wilhfn art area. These 
characteristics ma*e an array -representation more suitable than a vetlor representation for, say, a 
space w,ir program, where the space ship must be redisplayed rapidly, and consists ol perhaps a 
large number of vectors confined td smal area of the screen. 11 also provider * "dipping” facility. 

Saving pom! arrays has a property nbt titled by LLOOCTs SNAP for the 340 — "What you 
see is what you get”, Everything within the designated area 15 indudrd, regardless of how it was 
caused to- appear -- vectors, text, point*, other EFX'V.DflET's, etc. This means thet you tan always tell 
wh^t will be included in a saved picture simply by looking, ?l the screen. 



MtAKKWlNDOtT - Rrihttr^ *aizr* [JlfJFl 


Creates a “window 1 *, \.e. t an array a I point;., and names il ^icJrrd'ois-jinmr--. Tl-^r suunWViic- 
Pfliw* should be a word, and ■should bo cho-sen so as not 1o conflict wilh miffing 1 unctions or 
arrays. The window is centered on I he lurlle’s currenl local ion, and evlcnds lor <«*e> turtle steps 
honforttall/ and vertically Irom ihe cenler. The faction of Ih? center of the window and ft* $i eo are 
remembered. 

WAKEWINDtM ^li'lPlrfrJtr Nr1Htr> *'ifirnri.znHai-:iixrt> 

Creales a window centered on trie leu-tie's currenl local ion, hut sals the horiyonlat and 
vertical sizes ol the window indepcndenlly, so the area saved can be rectangular instead Of square* 
3k% in the One input mode. 

W ZiKKWfNPOW ^i.surer- r 1- ^rrritxr!r-y> h.mrizrinnif-ii*c> -sr.vrfiVei-trte^ 

Creales a window cenle+ed on the ■specified location, o' Ihe specified size. If Ihe <vr.nir.al- 
n 2 p> is omitted it 13. assumed identical So Ihe 

ERflSKWiWmW <Hjndiw-nanH* \ ffiF} 

Destroys Ihe window specified by <ti<iit4i»w-.noinf > . |l Ihe window is no longer needed, this 
permits the space lhat d occupied to be reclaimed. 

ERASEWfNWOtrS \ JvtFS] 

Erases all currently del mod window?, 

.WINDOWS 

Global variable which ceniams a list ol all currently defined windows 

WINDOWFMMK,... W?} 

Takes inputs like HflKEWINDQW, Orcepl for the window name. Thai is. il lakes from cane 
(0- Four inputs specifying, a size and optionally a center location, WINDOWF JMWB displays a ho* on, 
tho screen which incicates Ihe exlenl of Ihe picture which would he saved by a M/IK f-'PT J iV OfjJ#' Ol 
Ihe corresponding size and DcatiOn This is useful in deciding how large a w«ndow is necessary 
before using NOKEWiNDGW, The bo* is XORed into the screen, so that giving the 
IFT •VWJPFF'FI/lffE command sa*in wifi caus-e the bo* to disappear, If no inpuls are given to 
WtNDQWbftAMK the size and location default Id Ihe Iasi ones specified. 

SIlOWWINDOW «WHd l e»'NrtRte> JS1FJ 

Causes the specified window 1o be displayed at the location at which it was originally 
created, Currently, wraparound i* not a’lpwed; display of the picture is not allowed 10 cross the edge 
of the display area. Changing TT^fZiE and 5JZfi have nq eflett <Jh the sire ot saved 

pictures 
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Sit QITlFf lYFKHF *t£ 1 Hiffllii-JWrmiP ^n^(c-rrrt[f’r-r> <rau i i:«lal( , r !l -]f> 

Gauges the window Id be displayed- at the new location specified, 

HMRIFINDOW . .. . IIIIFJ 

Accepts arguments liVe SlfOtP WINDOW, but display? the window turning oFF any posinl. 
which was or* in Ihe window when d was- treated- TV etfecl of Shit i-s as iF the picture were 
redrawn in eraser mode, If a call to 5fJOEFil'iF.YRQJF displayed the w'ndow On ? Wan* area, a 
Simitar K.A>\ to HlDHinmW\r wilt erase ih El SI/OIFiriJVIWSF superimposed Ihe window on 
something already displayed, the dd picture is not guaranteed to remain intact aFter the window is 
hidden, 

xomriNonir .... { iff - 3 

Like SIIQWWI&DOH' and tttBEWWDOW, but HOT* the picture into the screen. 

WtStKlWiitmE <u»^in^nam^ ^FffT 

IT I \T)0irif0MF. <tvindnir. itrrPin^ ^neKJ-*-AonK> ^nvai-y-Jiamr*' 

Changes thn- home location associated with a window Id the specified Ideation, defaulting to 
ftFRE. This is the location where I ho renter of the window wi I b* displayed if only Ihe nemo 0-F I he 
wrodow it given at input to SlIOIViFINDOW. MDtMiNMW. ale, 

f/lL'fitr/.VFjii'jfry jws} 

Creates a file on the disk which saves all currently dfrfrned windows in binary. They can be 
reloaded at a laler time with Gf’TlF INflQWS- The file specific at ion follows the same Format as Other 
LLQGQ file commands such; as RE/lDFH.E t and LlSP’s URE/ID. TV filenames- are not rvilusted 1 - 

CFnr/^noirs <iur*i*r> [gif] 

Reloads windows from a disk file created by SfWT,WI FYfMIFS. 


17.17 Printing Piclures on the XGF 

Pictures drawn with Ihe LLQGQ TV turtle may be printed 0 * Ihe Al Lab 1 * Xeroir Graphics 
Printer to oblain hard copy The following primitive creates a file which can be printed by tha XGP 
control program SCfilkP, 


XG'P ^urm 1. 


Creates j» file saving the picture in the designated area oF tV screen, The file can fh^sn be 
prlnled on the VGP, The file specification follows the- same far-mat as other LLQQO file commands — 
from one td Tour wards. A rectangular area limiting the picture saved is specified m- the same- formal 
accepted by the window commands — from One to four numbers, ff omitted, the area detaulls to the 
entire screen. tyampFo; 

XUF PtCWHR > m .HMt Jtfff 

lives Ihe picture extending for t&0 turtle steps horizontally ?rid vertically from the point (2QQ, 30Q)- 



in the File PICTURE s on I he current directory. Captions cm be printed on the screen using Ihe 
iWVTfiK command and will appear on the printed picture, ^he pic lures will be approximately I be same 
si?e as they appear or I he TV screen. Currently p clures saved are limileo So 300 by 300 TV points. 

Twb wjrmnjs concerning KGP pictu r es: First, She XGF has a problem common to alt Xerq* 
machires an inability to reproduce Iarg.* black regions, An attempt to print a picture wi1t> areas 
1ilitre! m black will cause Ihc black regions 1o ''while Oul*. Pictures created by using the SHADE 
command to shade regions wdh dense patterns wdl not b* printed correctly on the XGP, Also, it ts 
best to try to limit the area pi the screen saved id as small an area as possible. Since picture files 
must bo output lo I he XGP fast erough to insure that one I ne 'S printed bdore Ihc ntt*\ Or*; is tead, 
l.irp.c Files may ’Qse when the syslem is crowded 7 he symptom of Ihis soft ot fossage is blank 
hori^onlfll hands, in Ihe m ildle of the picture. More efficient XGP commands 1o be implemented soon 
wiH reduce I he likelihood of this sorF oF Fossage. Images on the TV screen drawn by the TV turtle 
can also tie prmlgd using the Tektronix hard copy marh np, 


17.15 Shading 

A unique advantage of the TV (frsptoys over yeclor oriented displays is tM in addition to 
the display of line drawings, they make feasible the ere a! ion at pictures, using shaded areas. 
Pattern^ of points of varying densities can ou used to 1iH reg ons, creating 1 he e^Fect of a "gray 
sca'e". The TV turtle's sliacring. Facility is aimed toward creating a convenient »nd rrflicnnr mean; of 
specifying areas 1o be shaded, pnd patlerns. to be used in «had>np,. The basic idea is that reg-uns to 
be shaded are indicated by drawing a dosed curve around them ii> PENDOWh' made,, arvd placing the 
lurttf! inMiir the? region 'before issuing Ihp SiiADH command, with, an argument determining fhg 
pattern to be used. Several simple pal terns are supplied by the system, bul the user has the 
opportunity of defining new ones. 

SHADE ^pftifitrn na-jne* 

Shades the area enclosing the turtle's current location. The input is a pattern to be used in 
shading tho aroa„ and defaults to the SO/JO pattern if 0Tidied. The turtle must be sitling. in an 
empty area [not on a line or m a filled in region}, at an error results. The offset (rf this primitive is 
to fill in the region surrounding the turtle's tOcalibn with the shading paltern given [by inclusive 
QRing it in with the existing pictureJ. The region to 'be shaded mutt be bounded by a dosed curve; 
ii tf /| f)P, works by Filling in Ih^ pattern, starting Fn>m |ho turtle's location, and slopping when 4 
boundary is reached, If I he region is not closed, the enlire screen wilt be shadedl 


l7.lt! &hadfcng_PaJlrrns 

Shading patterns arp re-presented as funet ons wSifti tell the 5f.f A 0R primitive Fiow ip 
shade an area, The system provides a group Of predefined chad ng ppilorns, described below, These 
will probably be sufficient lor most simple uses oF shading, he. distinguishing a few neighboring 
regions wiih diHoront shading patterns, etc Those twudiflg more sophisticated capabilities can define 
their own patterns. The predef ned shading patterns currently available ere: 


SOLID 


A shading pattern which fills in every point. This pattern is the deFauM used if no argument 
15 given to SHADE, 
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Cl/ KCK KR 

A nattcm which Mb in every other point, in f.hctker board fashion, 
HOtilZLhVKS 

A pattern cons-isting oF horizontal line;, alternating light and dark. 

VfiRTUNRS 

Like HuHtXLINKS, e^cepl (intfs are w#i-tec-fil 


CTJJD 


So Nh horizontal and vertical hnoe, superimposed- 


TEXTURE 


A pattern which turns On points randomly, creating w lejtturrt like An average of hall 

the points will be lurned on. 

v/mKrtiXWHt-: 


MGtiTTKXWftft 

Lite rOTljflK t but shade using diluent densities. fll point*- JJ.flfiiKTfi'.tfTT.'iRf? turns on an 
average of 3/4 of the points, created by GR'ing two random numbers, Ll&ltITHXTVHFt averages 
1/4 of |he points, Obtained' by AN|>ng two randpm numberJ. 

New shad mg patterns consisting ot arbitrary pictures can be defined by using the following 
primitive: 

Ai/iKEP ATT KRAI ,r pinNrrn-nonK’> <irimfolE-iriaotr ' 1 (UP) 

The first argument is a name tor the new pattern. The second & the name of S window, 
constructed by the AMKEEF7V001F command. This creates a new pattern, which consists of the 
picture saved in the window. The pal tern name may then be given as input to SW/lfiP. The effect 
will bn to fill the closed curve to be shaded with the picture specified by the window. ]f area 
beyond the ejtlenl oF the Original picture is Id be shaded, the picture- will he repeated horizontally 
and vertically as many times as <s necessary to fill the area. 

Alternatively, a shad ng pattern may be constructed by 1 he user direetty as a tunction, [This 
can result in faster shading than by using a peltem cOnsIrurlod by .If AKHPATTF, FtV, although it’s 
m&rc drffitutl to writs, especially Ior complex patterns,] A pattern is a function ot two integer 
arguments, X and ¥ coordinates Of a word in the TV memory [as tor the inputs, to TV, See Section 
i 7.22J [1 returns an integer, which indicates the stale of 37 bits ot thp screen, IHt justified. 


17,70 Invisible Mod* 


When a program does bolh a considerable amount OF graphics- as weh aS non-graphic 
■Lunpul;ifi i'j it often become; convenient to be able to debug these components separately. An 



"thviscblr?~ mode makes A possible Ip debug the non-graphic parts of a program! tCntwmnrg turtle 
command*, without incurring the overhead OF drewirg on the fctteen, When the system it. hejrvrly 
Ipaosd,. code run in "invisible" n*ode will run much latter, allowing, the user to run a procedure if he 
h not interested F n Ihe picture d-awn, Ihen return to 'visible" mode to debug the pictures d'iiwn by 
the program,, Pictures drawn in invisible mode ere not saved and reluming to visible mode requires 
the" programs he re-pvoculed lo observe the picture drawn. 

tMfSffliK 

Lnte r s 'invisib e" mocks-. Any pnmilive thal would £«se changes to pictures on the serephr 
movement of the turtle, display of saved pictures, points, elc will not cause anything on the screen 
to change while running in invisible moiln t rocut on ot procedures eonlairung, turlle primitives will 
proceed much Faster; this pi-rmls runn-ng ol procedures containing lurlle primitives for the purpose 
of debugging their non-graphic behavior. 

VISfliLH 


Returns to "visible-" mode. Turbo functions have them usual glfgcl, as weh as their usual 
slowness. VISIRlj: causes a Ct.KARSCRKKN 


I7.?l Ex tension* 

One possible source of extensions to the TV turtle package would be the inclusion ot 
picture-saving capabilities sinrlaF to the SNAP command of the LLQGO tuttte for the 340, Or to 
J 1 LOGO’S SNAP. Th $, would diFtrrr Irom the "windows' described above in lhal it would be a lowef- 
tevel repTcsentatron pF the picture in terms of vector Id be displayed, rather than an array ot 
points. Because the TW lermna s do not have hardware for display OF vectors, necessitating the 
compulation of pointy lying along a vector to draw it, redisplay of a snap would be very nearly ar. 
Urn*-consuming as re-executing tns L (tfiO procedure which drew the picture. to contrast, redisplay 
Of a window by passes that rccomoulahon, and requires much loss time lo redisplay than the original 
drawing procedure required. Now ever, a vector rcpra-senlation does provide several advantages, tl 
is less spflCfr-CQnsummn Ipr pictures which occupy torge pOrliOns Of Ihe screen, bul contain few 
vectors. IF can be used morr easily wilh pictures for which a desen pbcm jn terms ot rectangular 
portions of Mirj --.creeri would be inconvenient; lor cvample, an irregularly shaped picture tutrounfed 
by drawings not to be included in !hn saved p dure. The window r e urn-xml a* irjn makes it difficult to 
assign independent ramps lo Hoe saved graphic output of each of several programs if the pictures 
overlap. Certain. IranslOrmalions syf:h as rotations and scaling might be more easily pprlo-rmedl On a 
vector representation than on point arrays. 

An additional ditficully iri providing 3 snap facility m the TV turtle similar lo that possible 
wilh vector oriented displays would arise jn implemenl-ng ihe fifMS K SNAP command. ]f sever at 
tine-. Jill pass through a single po nt on the screen, ihe point must not be turned off until all lines arp- 
erased, [f one 'me is erased via gn KPASK SNAP, and olhe' lines si ill pass through the ooinl, the 
point tnijs! hpt bo turned off. This recuses keep vie track pf how many lines pass through e»ch point. 
Such information could be obta nrd Inj-n computing | he nt-srsechon and overlap Ot vectors displayed 
whenever a vector is drawn or erased, or by keeping a "reference count" for each point, 
incremented whenever a =mn passing through the pc nt is drawn, decremented when such a line is 
erased. Ttin eraser -mode of the TV lurtle turns oil* po-nfn nl 0 n=; tines d^awn regardless of their 
previous state. This makes it somewhat 'ess convenient than f.'ft/T5E SNAP for erasure of one ot 
severe! ovedappiog pictures, although fhe seme eFfect can be achieved by saving [ha previous 
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contents ol an area in a window belpre drawing. over it. Tn some cases, TOR mode C*n the use-d 
instead,, so that the same procedure can be used both to draw a picture, and to erase it. 

Another allernalive representation for picture elements would be run length encoding. This 
would record the contents of an area of the screen, as doers (Nr TV turtle "window". Each line ot the 
area is represented as a sequencer of numbers. The numbers in Ihe sequence aSteriwttly specify 
how many consecutive points are on r and bow mgujr consecutive points are otF. Like the wardow 
operation, this technique is capable ol being used with pictures containing shaded arras, which 
would not be possible with a representation consisting solely of vectors. Although it would require 
somewhat mpro compulation hire to redisplay than would a window, it would not prove quite as 
space consuming fqr largo and sparse pictures. It is not clea* whether l'-r tmv- and spnr.n tradeoffs 
involved would justify the use of this representation. 

E?ch alternative reoreseutatian For picture elements carries wilh it unique advanlages and 
disadvantages, in lerms ol time and soacc efljdtncy, ease cF modification, etc. Ralher than becoming, 
committed to a single representation, a Letter goal is Id provide flexibility by making available many 
options and allowing a user or an intelligent system to choose the representation according to the 
requirements of the application. 

An alternative to the TV turtles approach So pictures involving shading is to extend the 
LOGO concept of the turtle's "oen" and "eraser 4 to a "paintbrush". A "paint" consisting oF a particular 
shading pattern and a width For the paintbrush would be chosen by the user, When the turtle is 
moved after the execution of a flKl!$fttHfWN command, the shading pattern is drawn in an area 
extending Ipi (hr specified width on either side Ol the palh Ot the turtle’s move men!. However, this 
method has Ihe disadvantage that programs lo shade even very simple geometric figures can become 
quite c&mpficated. This mode might be useful however, if it wore oPssihie lo move the brush under 
control oF some analog input such as a light uen or mouse. Another possibility is to supply the 
system with specilic knowledge about shading common shaoes, such as circles, 

Other exlensibns to the TV turtle could center cm providing Facilities oriented towards 
animation, LOGO as a graphics language is primarily oriented toward the display ol sialic pictures; it 
is weak in some o' Ihe c-npatul E rs needed for convenienF generation of movies, A more extensive 
vocabulary of transformat Dns which can be applied to pklurss would be helpful. This could include 
rotation and scaling Ot saved piclures, Ihree dimensional coordinate IransFor mat ions, as welt as a 
convenient way of incorporating user defined transformations. Some means OF explicitly controlling 
the time in which changes happen lo the displayed piclure should be provided. Extension of the 
control structure to allow parallel execution 01 procedures would facilitate programming 
independently changes, lo the pi chirm which should occur simultaneously. 

Another capability which the system should have is some provision lor analog input. Such as 
from a light pen, joystick, 1 ablet, or mouse. TFws would allow ihe system- to obtain and manipulate 
Freehand skeFches. Convincing drawings of people or ob-jeds I hat would be diFlicUlt to construct 
from turtle programs could be read ly input and Ihqn manipulated by programs. Objects On the 
screen could bo selected hy » use* inter ad ively using a rubber band vector, which ■$ etten more 
convenient lhan typing, especially For children. 


I 1 ?.22 I lM pie mentatinn 


The Pdf’Li which conlrots the TV terminals maintains the user's screen in its memory, One 
bil per point. An )T5 system tall allows Ihe ll’s memory to be mapped into Ihe address space of j 
program running cm the PO^IO An initialicalion routine writlen in LAP assembly language per For ms 
this system cali, and sets up an array header which convinces [[JR Fhal this area of memory 1$ really 



th*r dat? 'or a l[$p two-dimensional integer array, This array is accessible directly by I he user whp 
finds the supplifd tuMIe prinirt-ves not suded 1o h<s needs, All changes to ihe display screen are 
performed directly by U$P STUft-tc, and I he reminder ol Ihe display package is written entirely in 


The following primitives are probably not nl general mterest, but are internal lb Ihe TV 
turtle pacKage, and night -conceivably be of use to a user desiring nonstandard apptitaliOns. 

TV *llnr> <(W«ni«-Wrtrrf iL 

This n Ihe array which holds the user’s TV buffer. A calf to TV returns » 3& bit fixed paint 
numtjer, which contain* two l& bit PCP1 L words, leFl justified. STOffEV into the array will cause 
the array and the user’s screen: lo bo modified as described in the discussion of DH/IWMQDE, 
below. Any such STORK 1 ?, shou'd keep The low O'der lour bits of each word zero. The first input 
counts numbe' of Imp's from Ihe top, from 0 to ^15*^. The second selects a word on the line., leH 10 
righl^ from Old 17 (tor a total of ] 0 * 32 - 576 bits per line], 

DH/IIFtftfjM? mot/r^ 

The PQPL1 has a feature which enables any attempt to write a word in the It's memory 
from lti« PUP 10 la result in a spcciFied boolean luncliort pi word being written and the word 
previously there ftti/Wi Motfk changes that spochicalio'n according to 'finite, which should be *n 
inlffger representing Ihe mode chosen from, ihe values of one of the M lowing atoms- f(J#f XOR 
ANDC. VO HP. F.QV, SfiTtf, SET?, r SET. For example, STUPE TV DIMli will turn the low 

order bit ol Che second 1$ bit wCwd ol the TV buffer on iF fOR mode is in eflcct, Off if /INDC mode 
is in effect, and complement whatever is there if in XOF mode. t)k/liTMOIW return? the number 
describing the rr*Odc previously n effect 

itJR/UFMQDF, 

A global variable conta*n>ng the current node number as set by the last call to 
DR/11TM0DK, 
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